执行 git push origin master 提示： Permission denied (publickey). fatal: Could not read from remote respository.

封面图 • 2025-10-19 • git

你遇到的错误信息是：

```
Permission denied (publickey).
fatal: Could not read from remote repository.
```

这个错误表示 Git 无法通过 SSH 访问远程仓库，原因是你没有正确配置 SSH 密钥，或者密钥没有被 GitHub（或其他 Git 托管平台）识别。

---

### ✅ 解决方法步骤如下：

#### 1. **检查是否已生成 SSH 密钥**
运行以下命令查看是否有 `.ssh/id_rsa` 或 `.ssh/id_ed25519` 文件（这些是常见的 SSH 私钥文件）：

```bash
ls -al ~/.ssh
```

- 如果没有看到 `id_rsa` 或 `id_ed25519`，你需要生成一个新的 SSH 密钥。
- 如果有，但提示权限问题，可以尝试修改权限：

```bash
chmod 600 ~/.ssh/id_rsa
```

---

#### 2. **生成新的 SSH 密钥（如果还没有）**

如果你还没有 SSH 密钥，可以使用以下命令生成一个：

```bash
ssh-keygen -t ed25519 -C "your_email@example.com"
```

- 如果你的系统不支持 `ed25519`，可以使用 RSA：

```bash
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```

然后按照提示选择保存路径（默认是 `~/.ssh/id_rsa`）和设置密码（可选）。

---

#### 3. **将公钥添加到 GitHub（或其他 Git 服务）**

生成密钥后，你会在 `~/.ssh/id_rsa.pub` 中看到公钥内容。复制该文件的内容：

```bash
cat ~/.ssh/id_rsa.pub
```

然后登录到 [GitHub](https://github.com/settings/keys) 或其他 Git 托管平台（如 GitLab、Gitee 等），在 **SSH and GPG keys** 设置中添加这个公钥。

---

#### 4. **测试 SSH 连接**

运行以下命令测试是否能成功连接到 GitHub：

```bash
ssh -T git@github.com
```

你应该会看到类似这样的消息：

```
Hi username! You've successfully authenticated, but GitHub does not provide shell access.
```

如果提示 `Permission denied`，说明密钥没有正确添加或未被识别。

---

#### 5. **确认 Git 配置的远程仓库地址是 SSH 格式**

确保你使用的远程仓库地址是 SSH 格式，而不是 HTTPS 格式。例如：

```bash
git remote -v
```

应该显示类似：

```
origin  git@github.com:username/repository.git (fetch)
origin  git@github.com:username/repository.git (push)
```

如果不是，可以用以下命令修改为 SSH 地址：

```bash
git remote set-url origin git@github.com:username/repository.git
```

---

### 🔁 其他可能的问题

- **SSH 代理未运行**：你可以运行 `eval "$(ssh-agent)"` 启动 SSH 代理，并用 `ssh-add ~/.ssh/id_rsa` 添加密钥。
- **防火墙或网络限制**：某些网络环境可能阻止 SSH 连接，可以尝试使用 HTTPS 方式推送（需要输入账号密码）。

---

### 🔄 使用 HTTPS 的替代方案（临时）

如果你暂时不想配置 SSH，可以改用 HTTPS 推送：

```bash
git remote set-url origin https://github.com/username/repository.git
```

然后执行：

```bash
git push origin master
```

此时 Git 会提示你输入 GitHub 账号和密码。

---

如果你需要更详细的帮助（比如你使用的是 Gitee、GitLab 等），请告诉我具体平台，我可以提供针对性指导。

执行 git push origin master 提示 ： Permission denied (publickey). fatal: Could not read from remote respository.

执行 git push origin master 提示： Permission denied (publickey). fatal: Could not read from remote respository.