小而专的 npm 包：如何从清单走到可靠依赖

awesome-micro-npm-packages 是一个按职责收集小型 Node.js/npm 模块的目录。它把数组、字符串、日期、对象、函数、数学、流、Promise、文件系统、浏览器、CLI、语义化版本和生成器等常见问题分门别类，适合发现可替代手写代码的候选项。它是发现入口，不是“清单里的包都应该安装”的背书。

怎样使用这份清单

1. 先按问题找类别，再从当前项目已有依赖中找答案；不要为了省几行代码增加一个长期依赖。
2. 看仓库最后提交、发布频率、维护者响应、CI、支持的 Node/browser 版本和 issue 状态。清单维护时间与单个包的维护时间不是一回事。
3. 打开包自己的仓库和 npm 元数据，核对 license、版本、发布文件、类型声明、ESM/CJS 入口、依赖树和安全公告。目录本身的许可不自动授予其列出包的代码许可。
4. 在锁文件中固定解析结果，并用项目实际构建与测试验证；不要只看 README 的微型体积数字。tree-shaking、重复依赖、压缩前后体积和冷启动成本都可能改变结果。
5. 评估失败语义、边界输入和维护替代方案。小模块便于理解，也可能让依赖树、升级协调和供应链审查变得更分散。

完整目录快照：17 类、130 个条目

以下逐项保留该快照中的包名，并用一句话标明其职责。它们只是原清单对项目的介绍，不代表当前仍维护、兼容或安全。

Array（16）

• is-sorted：检查数组是否已排序。
• array-first：取首项或前 N 项。
• array-last：取末项。
• arr-flatten：递归展平嵌套数组。
• dedupe：去除重复项。
• array-range：按范围生成数组。
• arr-diff：排除其他数组中的值并保留唯一差集。
• filled-array：创建由指定值填充的数组。
• map-array：把对象键值映射为数组。
• in-array：检查给定值是否存在于数组。
• unordered-array-remove：不保持顺序地快速删除数组元素。
• array-swap：交换两个位置的元素。
• mirrarray：从键名数组生成键镜像对象。
• group-array：把对象数组分组。
• array.chunk：将 Array 或 TypedArray 切成定长块。
• fast-cartesian：计算笛卡尔积。

String（19）

• decamelize：把驼峰字符串转为带分隔符的小写形式。
• pad-left：在字符串左侧补齐指定字符。
• to-camel-case：转换为 camelCase。
• to-capital-case：转换为 Capital Case。
• to-constant-case：转换为 CONSTANT_CASE。
• to-dot-case：转换为 dot.case。
• to-no-case：移除已有大小写风格并规范词间分隔。
• to-pascal-case：转换为 PascalCase。
• to-sentence-case：转换为句首大写形式。
• to-snake-case：转换为 snake_case。
• to-space-case：转换为以空格分隔的形式。
• to-title-case：转换为标题式大小写。
• node-slug：生成可包含 UTF-8 字符的 slug。
• rtrim：移除字符串尾部空白或指定字符。
• slice.js：提供类似 Python 的切片范围语义。
• strip-ansi：清除 ANSI 终端控制码。
• striptags：从字符串中剥离 HTML 标签。
• parse-next-json-value：从含额外文本的字符串中读取下一个 JSON 值。
• pluralize：生成单复数形式。

Date & Time（9）

• pretty-ms：把毫秒数格式化为易读时长。
• hirestime：封装高精度计时并简化时间差计算。
• periods：提供以毫秒表达的常用时间段常量。
• fecha：格式化和解析 JavaScript Date。
• akamai-time-reference：通过 Akamai 服务获取参考时间。
• timeago.js：格式化相对时间。
• count-days-in-month：计算指定月份的天数。
• time-stamp：生成格式化时间戳。
• twas：生成相对时间字符串。

Object（22）

• map-obj：把对象的键和值映射到新对象。
• filter-obj：按条件筛选对象键值。
• object-values：取得对象值数组。
• object-pairs：把对象转换成键值对数组。
• zipmap：把键和值配对构造映射。
• just-pluck：从对象集合中提取指定属性。
• deep-equal：深度相等比较。
• deep-assign：递归合并对象属性。
• set-value：按点分隔路径创建或设置嵌套值。
• get-value：按属性路径读取嵌套值。
• has-value：判断路径下是否存在非空值。
• has-key-deep：递归查找对象键。
• flatkeys：按分隔符展平层级键名。
• flatten-obj：把嵌套对象展平为键值对象。
• is-empty-object：检查对象是否为空。
• stringify-object：以便于阅读的形式序列化对象或数组。
• sorted-object：按键排序并返回对象副本。
• static-props：使用属性描述符定义静态对象属性。
• missing-deep-keys：找出第一个对象中第二个对象缺少的深层键。
• has-own-property：检查对象自身是否拥有某属性。
• merge-objects：深合并对象，并连接同名数组。
• deep-object-diff：保留嵌套结构地比较两个对象。

Function（8）

• compose-function：从小函数组合出 f(g(x))。
• curry：把多参数函数逐步转换成单参数调用。
• once：限制函数只执行一次。
• deep-bind：递归绑定对象内函数的上下文。
• identity-function：原样返回输入值。
• mem：缓存相同输入对应的计算结果。
• throttle-debounce：提供节流和防抖控制。
• compose-tiny：轻量函数组合实现。

Math（6）

• is-even：判断偶数。
• is-number：按包自身语义判断值是否为数字。
• is-odd：判断奇数。
• easy-math.js：封装加减乘除。
• my-prime：判断素数。
• fun-gcd：用欧几里得算法求最大公约数。

Stream（11）

• through2：简化创建 Node Transform 流。
• through2-filter：为流提供类似数组 filter 的处理。
• through2-map：为流提供类似数组 map 的处理。
• stream-spigot：生成可读流，便于测试或适配简单函数。
• concat-stream：收集写入流的数据后合并回调。
• JSONStream：流式解析或序列化 JSON。
• through2-map-promise：以 Promise 包装 through2 映射。
• pump：连接流，并在一段流关闭时清理整条管线。
• split：按行拆分流数据。
• is-stream：检查对象是否为 Node 流。
• syncthrough：同步转换流数据。

Promise（4）

• pify：把回调风格函数转成 Promise 风格。
• promise-all-props：对对象属性执行类似 Promise.all 的等待。
• sleep-promise：等待指定时长后完成 Promise。
• is-promise：检查对象是否具有 Promise/A+ 风格特征。

Data Structure（1）

• quetie：轻量队列/双端队列实现。

File System（7）

• rimraf：递归删除目录树，类似 rm -rf；使用前必须核对目标路径。
• mkdirp：递归创建目录，类似 mkdir -p。
• du：计算文件或目录大小。
• file-size：把字节数格式化为易读大小或比例。
• tmp：创建临时文件和目录。
• fs-promise：为 Node 文件系统方法提供 Promise 包装。
• read-git-user：读取本机 Git 配置中的用户名和邮箱。

Browser（7）

• delegate：轻量 DOM 事件委托。
• insert-css：向页面插入 CSS 字符串。
• dom-element-value：读取或设置 DOM 元素值。
• image-promise：以 Promise 等待图片加载。
• get-media-size：读取图片、视频、SVG、Canvas 等媒体尺寸。
• document-ready：监听文档就绪。
• copee：调用浏览器能力复制文本。

Semver（3）

• semver：解析和比较语义化版本。
• semver-max：按 semver 规则找最大或最小版本。
• semver-first-satisfied：找出第一个满足范围的版本。

CLI（6）

• abbrev：为字符串集合计算无歧义缩写。
• glob：按 glob 模式匹配文件路径。
• username：取得当前操作系统用户名。
• minimist：解析命令行选项。
• png-to-ico：把 PNG 转成 Windows ICO。
• help-version：处理 CLI 的 --help 和 --version。

Module management（2）

• pkg-conf：从最近的 package.json 读取命名空间配置。
• normalize-pkg：规范 package.json 字段以改善兼容和读取。

Generators（1）

• is-generator：判断值是否为生成器函数。

Other（7）

• uuid：生成 RFC 兼容 UUID。
• node-mime：提供 MIME 类型映射。
• not-defined：判断该包定义的未定义/空值集合。
• is-fqdn：判断字符串是否为完全限定域名。
• shurley：解析并修正常见输入错误的 URL。
• mime-type-check：按扩展名查询 MIME 类型。
• nanoid：生成短小、URL 友好的唯一 ID。

Tools（1）

• npm-deprecated-check：检查已弃用依赖并寻找替代项。

上游还提供的阅读线索

README 还列出以下文章标题、相关清单和模块作者目录。这里只保留标题/名称，不假装已经审阅这些文章的正文，也不把外部项目的当前状态作保证：

• One-line node modules
• Module best practices
• Evaluating Packages Part 1 - Turn to community
• Evaluating Packages Part 2 - Review repository
• Small modules: it is not quite that simple
• In Defense of Hyper Modular JavaScript
• Tiny npm package: Guidelines to create a Node.js module following the small package philosophy
• The cost of small modules

相关清单：awesome-nodejs、awesome-npm。README 中列出的模块作者/维护者关注名单：Sindre Sorhus、James Halliday、Eugene Sharygin、Isaac Z. Schlueter、Jon Schlinkert、Dominic Tarr、Rod Vagg、Max Ogden、Brian Woodward。它们是进一步发现项目的索引线索，不代表当前活跃度或背书。

选型检查表

• 正确性：纯函数是否真纯？空值、超大输入、非 ASCII 文本、时区切换和异常输入如何处理？
• 兼容性：包使用的 Node API、浏览器 API、module 格式和语法是否与最低运行环境相容？
• 供应链：是否有 install/postinstall 脚本？发布者和仓库一致吗？是否存在不必要的传递依赖？
• 安全：处理 URL、路径、HTML、正则或用户输入时，是否可能产生注入、路径穿越、ReDoS 或拒绝服务？
• 许可：项目的分发方式、闭源/商用场景是否满足包许可证和 NOTICE 要求？不确定时交给法务或合规流程核实。
• 退出成本：接口是否容易替换？是否能用少量项目内代码覆盖这个简单需求？

安装前先做一次本地核验

npm view <package> version license engines time repository dist.unpackedSize
npm ls <package>
npm audit --omit=dev

npm audit 不能代替代码审查，也不意味着没有报告就绝对安全。对关键生产依赖，应再检查 lockfile、上游安全公告与组织自己的扫描结果。

一个实用决策规则

当包的职责清晰、维护可验证、许可适用、依赖和体积可接受、错误语义匹配项目，并且能减少真实维护成本时再引入。否则，优先使用平台标准库或保留几十行有测试的本地实现。微型包的价值在于聚焦，不在于依赖数量。

来源与范围

GitHub 仓库页面标注 MIT，README 则写明作者在法律允许范围内放弃对“这份作品”的版权及相关权利；两者可能对应不同文件或对象范围。本文记录这个差异，不替作者或法律顾问作解释。目录许可不会自动覆盖其中每一个独立 npm 包；使用前仍需逐包核对许可证和 NOTICE。本文是按公开目录重写的离线索引，不复制上游文章正文。

返回开源仓库专题索引

固定清单快照（核对日期：2026-10-09）：parro-it/awesome-micro-npm-packages。