如何在npm中结合私有仓库使用semver版本规范？

我尝试在package.json中使用semver语法引入私有GitLab仓库，配置如下：

"dependencies": {
    "nwm-common-react": "git+https://gitlab.com/northwestmedia/nwm-common-react.git#semver:1.0.0"
}

执行npm install时出现权限错误：

npm error code 128
npm error An unknown git error occurred
npm error command git --no-replace-objects ls-remote ssh://git@gitlab.com/northwestmedia/nwm-common-react.git
npm error git@gitlab.com: Permission denied (publickey).
npm error fatal: Could not read from remote repository.
npm error
npm error Please make sure you have the correct access rights
npm error and the repository exists.

确认自己有权限，去掉#semver:1.0.0后可正常拉取main分支，使用分支名、标签也没问题，仅用semver语法时出错。试过^1.0.0、~1.0.0、1.0.x等格式均无效。

改用SSH链接：

"nwm-common-react": "git+git@gitlab.com:northwestmedia/nwm-common-react.git#semver:1.0.0"

出现新错误：

npm error code ENOVERSIONS
npm error No versions available for undefined
npm error A complete log of this run can be found in: /Users/jim/.npm/_logs/2025-05-23T19_58_34_640Z-debug-0.log

已确认版本号正确，尝试#semver:*也无法解决。

1. 校验Git仓库的标签规范 #

npm的semver:语法依赖仓库中符合语义化版本规则的Git标签（并非package.json里的version字段）。多数场景下，npm要求标签带v前缀（比如v1.0.0），而非裸版本号1.0.0。

先查看仓库现有标签：

git ls-remote --tags git@gitlab.com:northwestmedia/nwm-common-react.git

如果标签不带v前缀，添加并推送正确格式的标签：

git tag v1.0.0
git push origin v1.0.0

之后再用#semver:1.0.0或#semver:^1.0.0尝试安装。

2. 强制npm对目标仓库使用HTTPS #

npm处理semver:语法时，可能自动切换到SSH协议导致权限验证失败。可以通过配置强制该仓库用HTTPS：

npm config set gitlab.com:northwestmedia/nwm-common-react.git:protocol https

或者在项目根目录创建.npmrc文件，配置访问令牌和协议：

//gitlab.com/api/v4/packages/npm/:_authToken=你的GitLab个人访问令牌
gitlab.com:northwestmedia/nwm-common-react.git:protocol=https

注意：个人访问令牌需要具备私有仓库的读取权限。

3. 应急方案：本地链接依赖 #

如果上述方法暂时无法生效，可先用本地链接方式保证开发：

# 直接安装本地克隆的仓库
npm install ../path/to/nwm-common-react

# 或者使用npm link
git clone git@gitlab.com:northwestmedia/nwm-common-react.git
cd nwm-common-react
npm link
cd ../你的项目目录
npm link nwm-common-react

4. 升级/降级npm版本 #

部分npm版本对Git URL的semver语法存在兼容性bug，尝试切换到稳定版：

# 升级到最新稳定版
npm install -g npm@latest

# 或降级到已知兼容的版本（如npm 9.x）
npm install -g npm@9

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