解决 npm install 报错：git ls-remote exit code 128

解决 npm install 报错：git ls-remote exit code 128

问题描述

在安装依赖的时候执行 npm install xxx，控制台报错如下：

Command failed with exit code 128: git ls-remote [email protected]:xqq/webworkify-webpack.git HEAD
fatal: unable to access 'https://github.com/xqq/webworkify-webpack.git/': Recv failure: Connection was reset

解决方案

该错误通常由 SSH 连接问题引起，可通过生成并配置 SSH Key 解决。

1. 访问 GitHub SSH 文档。
2. 打开 Git Bash 终端，按照步骤生成一个 SSH key。主要命令如下（邮箱替换为你的 GitHub 账号邮箱）：

   ssh-keygen -t ed25519 -C "[email protected]"
   

3. 系统会生成一个公钥文件，默认路径通常在 C:\Users\Administrator\.ssh 下，具体路径可在生成过程中确认。
4. 访问 GitHub Keys 设置（需登录），点击 New SSH keys 按钮进入添加页面。
5. Title 自定义，Key type 使用默认的 Authentication Key。
6. 输入框填入之前生成的 .pub 文件内容。建议使用文本编辑器打开，复制以 ssh-ed25519 开头的内容。
7. 保存后，重新执行 npm install xxx 即可正常下载依赖。