Windows环境下因URL编码问题无法安装私有GitLab npm包

问题根源 #

Windows环境下npm对私有域包（@scope/package）的路径编码逻辑与Unix系统（如Mac）存在差异，导致包名中的斜杠被过度编码为%2f，GitLab私有npm仓库无法识别该路径，从而返回404错误。

解决方案 #

1. 为私有域配置正确的Registry #

针对@integrations域单独配置GitLab私有仓库地址，确保npm能正确识别包的来源：

npm config set @integrations:registry https://gitlab.orgname.com/api/v4/projects/118/packages/npm/

2. 配置GitLab访问令牌 #

确保npm有权限访问私有仓库，将你的GitLab个人访问令牌配置到npm：

npm config set //gitlab.orgname.com/api/v4/projects/118/packages/npm/:_authToken 你的GitLab令牌

注：GitLab令牌需要拥有read_package_registry权限

3. 升级npm到最新稳定版 #

旧版本npm在Windows下存在路径编码bug，升级到最新版可解决此类问题：

npm install -g npm@latest

4. 切换命令行工具执行安装 #

Windows的CMD对特殊字符处理存在局限，改用PowerShell或Git Bash执行安装命令：

npm install

5. 清理npm缓存 #

清除可能存在的缓存配置或错误包信息：

npm cache clean --force

完成以上步骤后重新执行npm install，即可正常拉取私有包。

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