SuperAPI AI 工具集

npm-publish

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:指导将包发布到 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 自动发布、撤销发布或私有仓库相关说明。