如何在发布前验证 npm 包的正确性
在将 npm 包上传至公共仓库之前，确保其功能完整且配置无误至关重要。直接发布存在风险，因为版本号一旦使用便无法重复。通过 npm pack 命令可以创建与实际发布时完全一致的压缩包文件（.tgz），用于本地或团队内部测试。
生成待发布的压缩包
执行以下命令将在项目根目录下生成一个以包名和版本号命名的 .tgz 文件：
npm pack
例如，若 package.json 中定义名称为 my-utils、版本为 1.2.0，则会生成 my-utils-1.2.0.tgz。该文件结构和内容均与正式发布版本相同。
模拟安装过程
要测试这个本地打包的模块是否能被正常引入，可在另一个项目的目录中执行安装操作。首先复制该 .tgz 文件到方便访问的位置，然后运行：
npm install ~/my-utils-1.2.0.tgz
这一步不仅会将包加入依赖项，还会触发所有相关的生命周期脚本（如 prepublishOnly 等）。
实践示例：搭建测试环境
假设我们要对名为 data-handler 的包进行预发布测试。
步骤一：构建测试工程
新建一个空目录作为测试项目，并初始化基本配置：
{
"name": "data-handler-test",
"private": true,
"license": "MIT",
"scripts": {
"test": "jest"
},
"devDependencies": {
"jest": "^29.0.0"
}
}
注意："private": true 和明确的许可证声明有助于避免意外发布测试项目本身。
步骤二：引入本地包
进入测试项目目录后，使用相对或绝对路径安装目标 tgz 文件：
npm install ../path/to/data-handler-1.2.0.tgz
此时 package.json 会自动更新依赖信息，类似如下形式：
"dependencies": {
"data-handler": "file:../path/to/data-handler-1.2.0.tgz"
}
步骤三：编写并运行测试
创建简单的单元测试来确认模块行为符合预期：
// __tests__/handler.test.js
const { processData } = require('data-handler');
test('should handle input correctly', () => {
const result = processData([1, 2, 3]);
expect(result).toEqual([2, 4, 6]);
});
随后执行：
npm test
成功输出表示模块已正确加载并可正常使用。
迭代开发中的更新机制
当源码发生变更时，只需重新执行 npm pack 并再次安装即可刷新依赖：
npm pack
npm install ../path/to/new-data-handler-1.2.0.tgz
这种方式不需要修改版本号，也无需清除缓存，非常适合持续集成场景下的快速验证。
