首页/开发/CI/CD 与发布速查/npm 包发布要点
构建与制品管理58 条

npm 包发布要点

发布到 registry 的最小流程:名称与版本唯一、权限与双因素认证、dist-tag 管理发布通道,可附加 provenance 声明来源。

CI/CD 与发布速查开发更新于 2026-10-12
命令npm publish(可带 --access public 与 --provenance)
标签dist-tag(latest/next/beta)控制默认安装解析
权限scoped 包与团队权限;自动化用 granular access token

发布流程

发布流程
npm ci
npm test
npm version patch --no-git-tag-version
npm publish --access public --provenance
发布前用 npm pack --dry-run 检查包内容:避免把测试数据与临时文件带上。

易错点

  • 本地直接 publish:跳过 CI 测试与环境约束,改由流水线发布
  • 发布即 latest:预发布通道用 dist-tag 隔离,避免用户默认装到未验证版本

数据来源与参考

  • npm Docs《npm publish》
  • npm Docs《Provenance》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌