使用 npm pack 命令可以将当前项目打包成一个 .tgz 格式的压缩包，这是发布前的标准准备步骤。执行该命令后，会在本地目录生成一个包含所有文件（受 .npmignore 或 files 字段控制）的归档文件，随后可通过 npm publish 将该包上传至 npm 仓库。确保在打包前已完成版本更新和入口文件配置，以避免发布错误内容。
如何配置打包范围以排除无关文件
默认情况下，npm pack 会打包项目中除被忽略规则外的所有文件。若需精确控制哪些文件进入包内，应在 package.json 中设置 files 数组，或在根目录创建 .npmignore 文件。例如，仅打包 dist/ 目录下的构建产物，可配置 "files": ["dist"]。这样能显著减小包体积并保护源码隐私。
{
"name": "my-package",
"version": "1.0.0",
"main": "dist/index.js",
"files": [
"dist",
"README.md"
]
}上述配置确保只有 dist 文件夹和说明文档被包含在最终生成的 .tgz 文件中。运行 npm pack 后，可通过解压查看确认内容是否符合预期。
立即学习“Java免费学习笔记（深入）”；
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
如何在发布前验证包的内容完整性
在正式推送至公共仓库前，建议先检查生成的 .tgz 文件内部结构。可以使用 tar -tzf <filename></filename> 命令列出压缩包内的所有文件路径，或者使用 npm pack --dry-run（如果支持）预览行为。此外，也可以将包安装到临时测试项目中，验证依赖解析和模块导入是否正常。这一步骤能有效避免因遗漏关键文件或路径错误导致的发布失败。
# 列出压缩包内容
tar -tzf my-package-1.0.0.tgz
# 或者在临时目录测试安装
mkdir test-install
cd test-install
npm install ../my-package-1.0.0.tgz
node -e "console.log(require('my-package'))"通过命令行工具直接检查压缩包内容是最可靠的方式。结合简单的安装测试，可以确保发布的包在实际使用中不会因结构问题而报错。注意检查 main 字段指向的文件是否确实存在于包内。
基于 package.json 中 version 字段的版本号管理问题
当 package.json 中的 version 字段未正确递增时，npm publish 会拒绝上传，提示版本已存在。因此，每次发布前必须使用 npm version patch、minor 或 major 来自动更新版本号并提交 Git 标签。这保证了包的唯一性和可追溯性，是自动化发布流程中的关键一环。
