Pycharm连接GitHub仓库详细步骤

在 PyCharm 中连接 GitHub 仓库，方便进行本地上传和下载（演示为Windows10环境）：

---

1. 配置 Git 和 GitHub

(1) 安装 Git

如果你的电脑尚未安装 Git，请先下载安装：

• Git 官方下载地址
• 安装完成后，打开终端（Windows 终端 / macOS 终端 / Git Bash），输入以下命令检查安装是否成功：

  git --version
  

  如果正确安装，应该会返回类似 git version 2.xx.x 的信息。

(2) 配置 Git 用户信息

在终端中输入：

git config --global user.name "你的 GitHub 用户名"
git config --global user.email "你的 GitHub 绑定邮箱"

(3) 生成 SSH 密钥（推荐）

GitHub 需要身份验证，你可以使用 SSH 方式：

ssh-keygen -t rsa -b 4096 -C "你的 GitHub 绑定邮箱"

然后查看生成的 SSH 公钥：

type ~/.ssh/id_rsa.pub

复制输出的内容，打开 GitHub：

• 进入 Settings > SSH and GPG keys
• 点击 New SSH Key
• 粘贴公钥，点击 Add SSH Key

测试连接：

ssh -T git@github.com

如果显示：

Hi username! You've successfully authenticated...

说明 SSH 连接成功。

---

2. 在 PyCharm 连接 GitHub

(1) 在 PyCharm 设置 Git

• 打开 PyCharm，点击 File → Settings（Preferences for macOS）→ Version Control → Git
• 在 Path to Git executable 里填入 Git 安装路径（一般是 C:\Program Files\Git\bin\git.exe）
• 点击 Test，如果显示 “Git executed successfully”，说明 Git 已正确配置。

(2) 连接 GitHub 账户

• 打开 PyCharm，点击 File → Settings（Preferences for macOS）→ Version Control → GitHub
• 点击 Add account
• 选择 SSH 或 Token
  • SSH 方式（推荐）：如果之前已添加 SSH Key，可直接选择 Use SSH executable
  • Token 方式：
    1. 点击 Generate Token
    2. 复制 GitHub 生成的 Token 并粘贴到 PyCharm 中
• 连接成功后，会看到 GitHub 账户信息。

---

3. 下载 GitHub 仓库到本地（Clone）

方式 1：使用 PyCharm Clone

• 打开 PyCharm，点击 File → New → Project from Version Control
• 选择 Git
• 在 URL 输入 GitHub 仓库地址（形如 git@github.com:your-username/repository.git）
• 选择本地存放目录，点击 Clone

方式 2：使用终端 Clone

• 打开终端，进入要存放项目的目录：

  cd /path/to/your/local/directory
  

• 执行 Clone 命令：

  git clone git@github.com:your-username/repository.git
  

• 进入项目文件夹：

  cd repository
  

---

4. 本地修改后上传到 GitHub

(1) 在 PyCharm 提交代码

• 右键 项目文件夹 → Git → Add
• 右键 项目文件夹 → Git → Commit
• 输入提交信息，点击 Commit
• 右键 项目文件夹 → Git → Push，代码会被推送到 GitHub。

(2) 使用终端提交代码

在项目目录下，执行：

git add .
git commit -m "更新内容描述"
git push origin main

如果你的默认分支不是 main，请改成 master 或其他分支名称：

git branch

查看当前分支后，再执行：

git push origin 你的分支名

---

5. 从 GitHub 拉取最新代码

(1) 在 PyCharm 拉取

• 右键 项目文件夹 → Git → Pull
• 选择 要拉取的分支，点击 OK

(2) 使用终端拉取

git pull origin main

如果有冲突，Git 会提示你手动合并修改的文件。

---

6. 创建和切换分支

(1) 创建新分支

git checkout -b 新分支名

(2) 切换分支

git checkout 目标分支

(3) 合并分支

切换到主分支后，合并其他分支：

git checkout main
git merge 其他分支名

---

如此一来，你就可以在 PyCharm 连接 GitHub，进行本地上传和下载了！喜欢就点个赞吧🚀