如何在NPM依赖配置中指定私有GitHub包的特定版本

报错原因 #

你遇到的pathspec did not match报错，核心原因是目标私有仓库中不存在和你填写的版本号完全匹配的tag或分支，Git无法定位到对应代码版本。

正确配置步骤 #

第一步：给目标包版本打tag并推送 #

进入mypackage的本地项目目录，操作如下：

• 切换到需要发布为1.2.3版本的对应commit
• 打版本tag，推荐统一加v前缀避免后续匹配错误：

  git tag v1.2.3
  

• 将tag推送到GitHub私有仓库：

  git push origin v1.2.3
  

你也可以直接打无前缀的tag：git tag 1.2.3，后续依赖配置里的版本号要和tag完全一致。

第二步：修改package.json依赖声明 #

在Git依赖地址末尾拼接#<完整tag名>即可，示例如下：

"dependencies": {
   "@myusername/myrepo": "git+https://ghp_mykey:x-oauth-basic@github.com/myusername/mypackage.git#v1.2.3"
}

常见问题排查 #

• 配置前先到GitHub仓库的「Tags」栏目确认目标tag确实存在，拼写、大小写完全匹配
• 除了tag，你也可以用commit hash指定版本，直接把#后替换为完整或前7位commit id即可，例如#a1b2c3d
• 如果安装仍报错，先删除本地项目的node_modules对应包、package-lock.json或yarn.lock文件，清除缓存后重新安装即可

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