使用Vue monorepo模板发布npm包报错：Cannot set properties of null (setting 'peer')

DevOps 小满

2026-7-9

解决vue-lib-template monorepo发布子包至npm的错误问题

针对你遇到的npm ERR! Cannot set properties of null (setting 'peer')错误，按以下步骤排查解决：

升级npm版本：该错误常见于npm 7.x早期版本，升级到稳定版可解决多数兼容性问题：
```
npm install -g npm@latest
```
通过工作区命令发布：不要直接进入子目录执行publish，在项目根目录执行工作区发布命令，让npm处理依赖关系：
```
npm publish --workspace=packages/lib
```
检查子包peerDependencies配置：打开/packages/lib/package.json，确认peerDependencies格式正确，无空值或语法错误，示例正确配置：
```
"peerDependencies": {
  "vue": "^3.0.0"
}
```
清理缓存并重装依赖：
1. 执行缓存清理：
```
npm cache clean --force
```
2. 回到项目根目录重装所有依赖：
```
npm install
```
确保子包已构建：先执行模板自带的构建脚本（根目录），确保发布的是构建后的产物：
```
npm run build:lib
```