用途:指导将包发布到 npm registry,适合首次发布新包、发布新版本或管理 npm 包。
必要用法:先确认登录状态,运行 npm whoami;未登录则运行 npm login。随后检查 package.json,确保 name(组织推荐使用 @org/pkg 作用域名)、version(符合 SemVer,如 1.0.0)、main/module/exports 入口、files 白名单正确,且 private 为 false 或缺失。用 .npmignore 或 files 数组排除测试、源码和配置文件,并可用 npm publish --dry-run 查看实际打包内容。若包需要编译(TypeScript、Babel 等),先运行 npm run build。
版本管理:发布前更新版本,npm version patch(1.0.0→1.0.1)、npm version minor(1.0.0→1.1.0)或 npm version major(1.0.0→2.0.0),该命令会修改 package.json 并创建 git tag。
发布:先执行 npm publish --dry-run 核对内容;作用域包首次公开发布使用 npm publish --access public;常规发布使用 npm publish。
发布后:推送提交与标签,运行 git push --follow-tags;随后在 npm registry 查看或用测试项目安装验证,可用 npm view <package-name> version 查看版本。
限制:资料未提供 npm 账号注册、双因素认证、CI 自动发布、撤销发布或私有仓库相关说明。