孔庆轩1. npm包发布的核心流程解析
作为前端开发者，我们经常需要将可复用的代码模块发布到npm仓库。但很多人第一次发布时都会遇到各种问题：测试包和正式包有什么区别？版本号该怎么管理？如何避免误操作？今天我就结合自己发布过30+个npm包的经验，详细拆解整个发布流程。
先明确两个概念：
- 测试包：通常用于内部验证，不会被正式项目引用
- 正式包：经过充分测试后发布的稳定版本
两者的发布流程90%相同，主要区别在于：
- 包命名规范（测试包需要加特殊标识）
- 版本号管理策略
- 发布的目标registry（可以指向测试环境）
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 测试包发布全流程
2.1 准备工作
首先确保已经：
- 安装Node.js（建议LTS版本）
- 注册npm账号（
npm adduser） - 登录（
npm login）
创建测试包时，包名需要遵循特殊约定。推荐两种方式：
- 加scope：
@yourname/test-package - 加后缀：
your-package-beta
bash复制# 初始化项目
mkdir test-package && cd test-package
npm init -y
2.2 关键配置
修改package.json：
json复制{
"name": "@yourname/test-package",
"version": "0.0.1-alpha.1",
"private": false,
"publishConfig": {
"access": "public"
}
}
特别注意：
- 版本号遵循semver规范，测试包建议用
0.x.x或带-alpha/-beta后缀 - 如果使用scope包，必须设置
"access":"public"
2.3 发布测试包
bash复制# 打包构建
npm run build
# 发布到npm
npm publish
发布成功后，可以在npm官网搜索到你的包，但会显示为预发布版本。
3. 正式包发布流程
3.1 版本管理策略
正式发布前需要：
- 确保所有测试用例通过
- 更新CHANGELOG.md
- 确定版本号升级