# @adviser/ts-xxhash 中文文档

规范地址：https://npmcn.com/package/%40adviser/ts-xxhash/

版本：1\.0\.2
npm 元数据更新时间：2025-09-10T09:18:04.920Z
中文译文更新时间：2026-11-05T20:40:21.201Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adviser/ts-xxhash
原文对照：https://npmcn.com/package/%40adviser/ts-xxhash/?lang=original
项目主页：https://github.com/mabels/ts-xxhash
源码仓库：https://github.com/mabels/ts-xxhash

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：257 kB，73 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2025-09-10T08:35:19.167Z
- 最新版本发布：2025-09-10T09:18:04.720Z
- 近 30 天下载量：25265（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

xxxHash 键入符

## 安装

```sh
npm install @adviser/ts-xxhash
```

也可以使用：`pnpm add @adviser/ts-xxhash`、`yarn add @adviser/ts-xxhash`、`bun add @adviser/ts-xxhash`

## README

# XxHash 的 Javascript 执行

## 概要

xxHash是一个非常快的散列算法(见细节) [这里](https://github.com/Cyan4973/xxHash). xxhashjs是它的一个Javascript执行,用100%Javascript写成. 虽然没有C版那么快,但考虑到当前Javascript在处理未签名的32位元整数方面的局限性,它的表现确实相当出色.

## 安装

在节点中:

```
npm install xxhashjs
```

在浏览器中,包含以下内容,并使用 _第二十四届_数字 :

```javascript
<script src="/your/path/to/xxhash.js"></script>
```

## 实例

-   一步内:

```javascript
var h = XXH.h32("abcd", 0xabcd).toString(16); // seed = 0xABCD
```

> 0xCDA8FAE4 (英语)

-   在几个步骤(在节点JS流中有用):

```javascript
var H = XXH.h32(0xabcd); // seed = 0xABCD
var h = H.update("abcd").digest().toString(16);
```

> 0xCDA8FAE4 (英语)

-   示例目录中的更多实例 :
    -   从文件数据计算 xxHash
    -   在浏览器中使用 xxHashjs

## 使用量

-   XXH为32位XXH和64位XXH分别提供2个功能,其签名相同:
    
    -   XXH.h32
    -   页:1
-   一步内: `XXH.h32(<data>, <seed>)` 数据可以是字符串,ArrayBuffer,也可以是NodeJS缓冲对象. 种子可以是数字,也可以是UINT32对象.
    
-   在几个步骤中: \* 即时开发出一个新的 XXH 对象 H: `XXH.h32(<seed>)` 或者说 `XXH.h32()` 种子可以放在后面与 `init` 方法
    
    ```
    * add data to the hash calculation:
    ```
    
    `H.update(<data>)`
    
    ```
    * finish the calculations:
    ```
    
    `H.digest()`
    

返回的对象可以转换为字符串 `toString(<radix>)` 或数字 `toNumber()`。 。 。 . 一次 `digest()` 已调用,可以重用该对象。 同样的种子将被使用或者可以更改 `init(<seed>)`。 。 。 .

## 方法

-   `XXH.h32()`
    
    -   `.init(<seed>)` 用给定的种子初始化XXH对象. 种子可以是数字,也可以是UINT32对象.
    -   `.update(<data>)` 添加散列数据 。 数据可以是字符串、 ArrayBuffer 或 NodeJS 缓冲对象。 \* `digest()` (单位:千美元)_UINT32 请检查URL=值 (帮助)_(中文(简体) ) 完成散列计算并返回一个 UINT32 对象。 散列值可以用 String () 检索 .
-   `XXH.h64()`
    
    -   `.init(<seed>)` 用给定的种子初始化XXH对象. 种子可以是数字,也可以是UINT64对象.
    -   `.update(<data>)` 添加散列数据 。 数据可以是字符串,ArrayBuffer,也可以是NodeJS缓冲对象.
    -   `.digest()` (单位:千美元)_联合INT64_(中文(简体) ) 完成散列计算并返回一个 UINT64 对象。 散列值可以用 String () 检索 .

## 许可证

麻省理工学院

## 常见问题

### @adviser/ts-xxhash 是什么？

xxxHash 键入符

### 如何安装 @adviser/ts-xxhash？

在项目目录运行 npm install @adviser/ts-xxhash，或使用 pnpm add / yarn add / bun add。

### @adviser/ts-xxhash 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @adviser/ts-xxhash 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @adviser/ts-xxhash 可以商用吗？

@adviser/ts-xxhash 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adviser/ts-xxhash 的下载量有多少？

根据 npm 官方下载统计，@adviser/ts-xxhash 在 2026/10/05 – 2026/11/03 这 30 天内被下载 25,265 次，日均约 842 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adviser/ts-xxhash 还在维护吗？

最新版本 1\.0\.2 发布于 2025/09/10（1\.2 年前）；至今共发布 3 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/09/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。