如何发布到cnpm和pnpm仓库

云边有个小卖部

除了官方npm仓库，国内常用的cnpm（淘宝npm镜像）和pnpm仓库也是开发者分享包的重要平台。以下是发布到这两个仓库的详细流程。

一、发布到cnpm仓库

cnpm（淘宝npm镜像）是国内常用的npm镜像仓库，发布流程与官方npm类似，但需要注意仓库地址的切换。

1. 了解cnpm仓库

cnpm仓库地址：https://registry.npm.taobao.org
发布到cnpm的包会同步到淘宝镜像，方便国内用户快速安装
注意：cnpm并非独立仓库，而是npm的镜像，发布机制与npm基本一致

2. 发布步骤

步骤1：切换npm镜像源到cnpm

# 查看当前镜像源
npm config get registry

# 切换到cnpm镜像源
npm config set registry https://registry.npm.taobao.org

步骤2：登录cnpm账号

如果已有npm账号，通常可以直接使用（cnpm与npm账号系统互通）：

npm login

输入用户名、密码和邮箱进行登录

步骤3：发布包

与发布到官方npm仓库相同：

npm publish

步骤4：验证发布结果

可以通过cnpm官网查询：

访问 https://cnpmjs.org/
在搜索框输入你的包名进行查询

步骤5：切换回原镜像源（可选）

# 切换回官方npm镜像
npm config set registry https://registry.npmjs.org

3. 注意事项

cnpm发布的包通常会在短时间内同步到官方npm
发布失败的常见原因与官方npm相同，可参考前文的错误处理方法
国内用户安装时可以使用cnpm install 包名命令

二、发布到pnpm仓库

pnpm是另一种包管理工具，同时也有自己的包仓库。发布到pnpm仓库的流程略有不同。

1. 了解pnpm仓库

pnpm官方仓库：https://registry.pnpm.io
pnpm支持发布与npm兼容的包
发布到pnpm仓库的包可以被pnpm、npm和yarn用户使用

2. 发布步骤

步骤1：安装pnpm（如果尚未安装）

# 使用npm安装pnpm
npm install -g pnpm

# 验证安装
pnpm -v

步骤2：切换到pnpm仓库

# 设置pnpm仓库地址
pnpm config set registry https://registry.pnpm.io

步骤3：登录pnpm账号

如果没有pnpm账号，需要先在 pnpm官网注册

pnpm login

输入用户名、密码和邮箱进行登录

步骤4：发布包

使用pnpm的发布命令：

pnpm publish

步骤5：验证发布结果

访问 https://pnpm.io/packages
搜索你的包名查看是否发布成功

3. 注意事项

pnpm发布的包默认支持pnpm的工作区和依赖管理特性
pnpm发布命令与npm兼容，也可以使用pnpm publish --access public指定公共访问权限
如果包已经发布到npm，也可以通过pnpm add 包名安装，pnpm会自动从npm仓库拉取

三、一次性发布到多个仓库的技巧

如果需要同时发布到npm、cnpm和pnpm，可以使用以下工具和方法：

1. 使用npm包发布工具

如np或release-it，可以配置多个仓库地址：

# 安装release-it
npm install -g release-it

# 初始化配置
release-it init

在配置文件中设置多个仓库地址，实现一次发布到多个仓库

2. 编写发布脚本

在package.json中添加发布脚本：

{
  "scripts": {
    "publish:npm": "npm publish --registry https://registry.npmjs.org",
    "publish:cnpm": "npm publish --registry https://registry.npm.taobao.org",
    "publish:pnpm": "pnpm publish --registry https://registry.pnpm.io",
    "publish:all": "npm run publish:npm && npm run publish:cnpm && npm run publish:pnpm"
  }
}

然后执行一次性发布到所有仓库：

npm run publish:all

四、常见问题与解决

发布权限问题
- 确保使用正确的账号登录对应仓库
- 检查包名是否已被占用
发布后无法立即搜索到
- 仓库同步需要时间，通常几分钟到半小时不等
- 可以直接通过包的URL访问：仓库地址/包名
版本号冲突
- 每个仓库都需要唯一的版本号
- 升级版本号后再发布新版本
发布速度慢
- 国内用户发布到npm官方仓库可能较慢，可先发布到cnpm
- 检查网络连接，必要时使用代理

通过以上步骤，你可以将包发布到cnpm和pnpm仓库，扩大包的使用范围，方便不同地区和不同包管理工具的用户使用你的插件。