在 IntelliJ IDEA 中配置 GitHub SSH 连接

在 IntelliJ IDEA 中配置 GitHub SSH 连接

你已经在本机配置好 SSH key，现在需要在 IDEA 中连接 GitHub。以下是详细步骤：

1. 验证本地 SSH 配置

首先确认你的 SSH key 已正确配置：

ssh -T git@github.com

如果看到类似 “Hi username! You’ve successfully authenticated…” 的消息，说明 SSH 已配置好。

2. 在 IDEA 中配置 GitHub 账户

方法一：通过 SSH 认证

1. 打开 IntelliJ IDEA
2. 进入 File > Settings (Windows/Linux) 或 IntelliJ IDEA > Preferences (macOS)
3. 导航到 Version Control > GitHub
4. 点击 + 添加账户
5. 选择 Log In via GitHub... 或 Use Token...
6. 推荐选择 Use SSH 选项

方法二：手动配置 Git

1. 进入 File > Settings > Version Control > Git
2. 确保 Path to Git executable 正确指向你的 Git 安装路径
3. 在 SSH executable 选择 Native (使用系统自带的 SSH)

3. 克隆 GitHub 仓库

1. 点击 Get from Version Control (欢迎界面) 或 File > New > Project from Version Control
2. 选择 GitHub
3. 确保 URL 使用的是 SSH 格式：git@github.com:username/repo.git
4. 点击 Clone

4. 提交和推送更改

1. 修改文件后，右键项目选择 Git > Commit
2. 输入提交信息后，可以勾选 Commit and Push
3. 确保推送时使用的是 SSH 协议

常见问题解决

问题1：认证失败

• 确认 ~/.ssh/config 文件配置正确
• 尝试在终端运行 ssh-add ~/.ssh/id_rsa (或你的私钥文件)

问题2：URL 协议错误

• 确保仓库 URL 是 SSH 格式而非 HTTPS
• 可以在 GitHub 仓库页面点击 Code 按钮选择 SSH 选项

问题3：权限问题

• 确保你的 SSH key 已添加到 GitHub 账户
• 在 GitHub 设置中检查 SSH and GPG keys

额外提示

1. 可以在 IDEA 终端中测试 Git 命令是否工作正常
2. 使用 git remote -v 检查远程仓库 URL 是否是 SSH 格式
3. 如需切换远程 URL 协议：

   git remote set-url origin git@github.com:username/repo.git
   

完成以上步骤后，你应该可以在 IDEA 中通过 SSH 顺利连接和操作 GitHub 仓库了。