如何通过package.json加载Azure DevOps工具仓库至主项目？

核心原因与对应解决方案 #

1. 修正npm依赖的Git URL格式 #

直接使用克隆链接会导致npm创建符号链接，需在链接前添加git+前缀，正确格式如下：

• SSH格式（需本地已配置Azure DevOps SSH密钥）：

  "dependencies": {
    "webapputils": "git+ssh://git@ssh.dev.azure.com:v3/GlobalApps/WebAppUtils/WebAppUtils"
  }
  

• HTTPS格式（公开仓库可直接使用，私有仓库需嵌入个人访问令牌PAT）：

  "dependencies": {
    "webapputils": "git+https://dev.azure.com/GlobalApps/WebAppUtils/_git/WebAppUtils"
  }
  

  私有仓库需替换为带PAT的格式：git+https://<你的PAT>@dev.azure.com/GlobalApps/WebAppUtils/_git/WebAppUtils，PAT需具备代码读取权限，可在Azure DevOps用户设置中生成。

2. 确保工具仓库符合npm包结构 #

工具仓库根目录必须包含package.json，且：

• name字段需与主项目依赖中填写的webapputils完全一致（npm包名区分大小写）
• 需通过main字段指定入口文件（如"main": "index.js"），或根目录存在默认入口文件index.js

3. 指定明确的版本引用（可选） #

若需固定依赖版本，可在URL后追加分支名、标签或提交哈希：

"dependencies": {
  "webapputils": "git+ssh://git@ssh.dev.azure.com:v3/GlobalApps/WebAppUtils/WebAppUtils#main"
}

4. 重新执行依赖安装 #

删除现有缓存文件后重新安装：

rm -rf node_modules package-lock.json
npm install

5. 升级npm版本 #

旧版npm对Git仓库依赖的处理存在兼容性问题，建议升级至最新稳定版：

npm install -g npm@latest

内容的提问来源于stack exchange，提问作者omega