# 05h 中文文档

规范地址：https://npmcn.com/package/05h/

版本：1\.0\.0
npm 元数据更新时间：2026-09-11T10:26:26.696Z
中文译文更新时间：2026-10-31T11:21:31.151Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/05h
原文对照：https://npmcn.com/package/05h/?lang=original

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

- 包体积（解压后）：4.2 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=14
- 运行依赖：0 个
- 首次发布：2026-09-11T10:26:26.144Z
- 最新版本发布：2026-09-11T10:26:26.458Z
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

稳定的32位字符串散列（FNV-1a）与bucket helper。零依赖关系。

## 安装

```sh
npm install 05h
```

也可以使用：`pnpm add 05h`、`yarn add 05h`、`bun add 05h`

## README

# 05年h

稳定的32位字符串散列（FNV-1a）与bucket helper。零依赖关系。

相同的输入总是在每个平台上产生相同的无符号32位整数 每个节点版本-适合稳定分片，缓存键和可复制 (播种)排序。

```js
const hash = require('05h');

hash('hello');          // 1335831723
hash('hello');          // 1335831723   (always the same)
hash('hello', 100);     // 23           (in [0, 100))
hash.bucket('id', 8);   // 0..7         (shard index)
```

## API

### `hash(value, modulo?)`

| 论点 | 类型 | 描述 |
| --- | --- | --- |
| `value` | `string` | 输入。非字符串被强制使用 `String()`. |
| `modulo` | `number?` | 当给定时，结果被简化为 `[0, modulo)`． 无效模将被忽略。 |

返回无符号32位 `number`.

### `hash.bucket(value, buckets)`

方便的包装器返回一个稳定的索引 `[0, buckets)`.

## 笔记

不是加密散列-不要出于安全目的使用它。

## 许可证

麻省理工学院

## 常见问题

### 05h 是什么？

稳定的32位字符串散列（FNV-1a）与bucket helper。零依赖关系。

### 如何安装 05h？

在项目目录运行 npm install 05h，或使用 pnpm add / yarn add / bun add。

### 05h 支持 TypeScript 吗？

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

### 05h 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### 05h 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=14。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### 05h 可以商用吗？

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

### 05h 还在维护吗？

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