使用SSH密钥时NPM无法安装Bitbucket URL依赖的问题

核心问题定位 #

你当前的依赖URL格式有误，git+ssh://git@bitbucket.org:username/repo.git里的冒号是SSH端口语法，但Bitbucket仓库路径应该用斜杠分隔，这会导致npm解析URL时出错，转而尝试HTTPS方式访问，因此要求输入账号密码。

具体修复步骤 #

• 修正依赖URL格式
  将package.json里的依赖项改为正确格式，把bitbucket.org:后的冒号换成斜杠，同时补全JSON语法要求的双引号：

  "dependencies": { 
      "test-module": "git+ssh://git@bitbucket.org/username/repo.git#v1.0.0"
  }
  

• 验证git SSH访问有效性
  先手动执行git clone git@bitbucket.org:username/repo.git确认SSH密钥能正常访问仓库，确保没有权限问题。

• 清除npm缓存后重试
  执行以下命令清除缓存，避免旧配置干扰：

  npm cache clean --force
  rm -rf node_modules package-lock.json
  npm install
  

• 强制npm使用指定SSH密钥
  如果上述步骤无效，可以临时指定git使用你的SSH密钥执行安装：

  GIT_SSH_COMMAND="ssh -i ~/.ssh/your_private_key_file" npm install
  

  替换~/.ssh/your_private_key_file为你实际的私钥路径。

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