【Git】 ssh-keygen 不是内部或外部命令，也不是可运行的程序或批处理文件。

封面图 • 2026-01-08 • git

你遇到的错误信息：

```
ssh-keygen 不是内部或外部命令，也不是可运行的程序 或批处理文件。
```

这表示你的系统无法找到 `ssh-keygen` 命令。通常是因为以下几种原因：

---

### ✅ 1. **SSH 工具未安装**
`ssh-keygen` 是 OpenSSH 的一部分，如果你没有安装 SSH 工具（尤其是 Windows 系统），就会出现这个错误。

#### 解决方法：

##### 🔧 Windows 系统：
- **使用 Git Bash**：如果你安装了 [Git for Windows](https://git-scm.com/)，它自带了 `ssh-keygen`，你可以通过 **Git Bash** 来运行该命令。
- **安装 OpenSSH**：
  - Windows 10/11 自带 OpenSSH，但可能未启用。
  - 打开 PowerShell，以管理员身份运行以下命令来启用：
    ```powershell
    Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
    ```
  - 安装完成后，重启电脑。

##### 🐧 Linux / macOS 系统：
- 大多数 Linux 和 macOS 系统已经预装了 OpenSSH，可以尝试直接运行：
  ```bash
  ssh-keygen
  ```
- 如果没有安装，可以通过包管理器安装：
  - Ubuntu/Debian:
    ```bash
    sudo apt-get install openssh-client
    ```
  - macOS (使用 Homebrew):
    ```bash
    brew install openssh
    ```

---

### ✅ 2. **环境变量未配置**
如果 `ssh-keygen` 虽然已安装，但系统找不到它的路径，可能是环境变量没有设置。

#### 检查方法：
在命令行中输入：
```bash
where ssh-keygen
```
（Windows）或者
```bash
which ssh-keygen
```
（Linux/macOS）

如果没有输出，说明路径不在环境变量中。

#### 解决方法：
将 `ssh-keygen` 所在目录添加到系统环境变量中。例如：

- **Windows**：
  - 找到 `ssh-keygen.exe` 的位置（比如：`C:\Program Files\Git\usr\bin`）
  - 右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”
  - 在“系统变量”中找到 `Path`，添加上述路径

- **Linux/macOS**：
  - 一般默认路径在 `/usr/bin/ssh-keygen`，不需要额外配置

---

### ✅ 3. **使用了错误的终端**
有些终端（如 CMD、PowerShell）可能没有正确识别 `ssh-keygen`，建议使用：

- **Git Bash**（推荐）
- **WSL（Windows Subsystem for Linux）**
- **Terminal / iTerm2（macOS）**

---

### ✅ 4. **检查是否拼写错误**
确保你输入的是 `ssh-keygen`，而不是 `sshkeygen` 或其他拼写错误。

---

### ✅ 5. **测试命令**
安装或配置好后，运行以下命令测试是否正常：
```bash
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```
这会生成一个 RSA 密钥对。

---

### ✅ 总结
| 问题 | 解决方案 |
|------|----------|
| SSH 工具未安装 | 安装 Git for Windows 或 OpenSSH |
| 环境变量未配置 | 添加 `ssh-keygen` 的路径到 `PATH` |
| 使用错误终端 | 使用 Git Bash / WSL / Terminal |
| 拼写错误 | 检查命令是否正确 |

---

如果你告诉我你使用的操作系统（Windows / Linux / macOS），我可以提供更具体的步骤。

【Git】 ssh-keygen 不是内部或外部命令，也不是可运行的程序 或批处理文件。

【Git】 ssh-keygen 不是内部或外部命令，也不是可运行的程序或批处理文件。