一篇带你了解PyCharm + Git + GitHub 实现本地代码上传到 GitHub 仓库_pycharm连接github仓库并上传代码
目录
第一步：准备工作
1. 安装必要工具
2. 配置 Git（第一次使用需设置）
第二步：在 GitHub 上创建仓库
第三步、Git 连接 GitHub 的完整步骤
1. 检查是否已有 SSH Key
2. 生成新的 SSH Key
3. 将 SSH Key 添加到 ssh-agent
4. 将公钥（id_rsa.pub）添加到 GitHub
5. 测试 SSH 连接
第四步：pycharm中绑定git和github
第五步：在 PyCharm 中管理项目
1、情况一：下载 GitHub 仓库到本地（Clone）
2、情况二：本地修改后上传到 GitHub
3、情况三：从 GitHub 拉取最新代码
4、情况四：创建和切换分支
关键概念解释
第一步：准备工作
1. 安装必要工具
-
PyCharm：下载社区版（免费）
-
Git：下载安装
-
GitHub 账号：注册
（安装软件可以找其他文章，先把需要的应用下载下来）
2. 在 GitHub 上创建仓库
-
登录 GitHub，点击右上角 + → New repository。
-
填写仓库名（如
my-first-project），选择 Public（私有仓库需付费）。 -
勾选 Initialize this repository with a README（可选）。
-
点击 Create repository。
第二步、Git 连接 GitHub 的完整步骤
1. 检查是否已有 SSH Key
在终端（Windows：Git Bash / Mac/Linux：Terminal）运行：
# 检查现有密钥ls -al ~/.ssh-
如果看到
id_rsa（私钥）和id_rsa.pub（公钥），跳到 步骤 3。 -
如果没有，继续下一步生成密钥。
2. 生成新的 SSH Key
运行以下命令（替换为你的 GitHub 邮箱）：
ssh-keygen -t rsa -b 4096 -C \"your_email@example.com\"-
按回车接受默认保存路径（
~/.ssh/id_rsa）。 -
设置一个密码（可选，增加安全性）。
输出示例：
Your public key has been saved in ~/.ssh/id_rsa.pub3. 将 SSH Key 添加到 ssh-agent
让系统自动管理密钥：
eval \"$(ssh-agent -s)\" # 启动 ssh-agentssh-add ~/.ssh/id_rsa # 添加私钥（如果设置了密码，此时会提示输入）
4. 将公钥（id_rsa.pub）添加到 GitHub
-
复制公钥内容：
cat ~/.ssh/id_rsa.pub选中输出的全部内容（从
ssh-rsa开头到邮箱结尾），复制。 -
在 GitHub 添加公钥：
-
登录 GitHub → 点击右上角头像 → Settings → SSH and GPG keys → New SSH key。
-
Title：自定义名称（如
My Laptop）。 -
Key：粘贴复制的公钥内容。
-
点击 Add SSH key。
-
5. 测试 SSH 连接
ssh -T git@github.com如果看到：
Hi 你的GitHub用户名! You\'ve successfully authenticated...说明配置成功！🎉
第三步：初始化本地仓库并关联远程仓库
1、配置 Git（第一次使用需设置）
打开终端（Windows：Git Bash / Mac：Terminal），运行：
git config --global user.name \"你的GitHub用户名\"git config --global user.email \"你的GitHub注册邮箱\"2、打开 Git Bash 或终端，进入本地项目的根目录，然后执行以下命令：
3、初始化本地仓库：
git init4、添加远程仓库地址：
将远程仓库地址与本地仓库关联，使用以下命令：
git remote add origin git@github.com:your-username/your-repo.git如果需要检查远程仓库地址是否正确，可以运行：
git remote -v第四步：pycharm中绑定git和github
1、Git
启动PyCharm，点击【File】→【Settings】→【Version Control】→【Git】，选择Git可执行文件路径（系统安装git后此处会默认显示路径），点击【Test】，路径下会显示当前Git版本
2、GitHub
点击【File】→【Settings】→【Version Control】→【GitHub】，点击【Log In via GitHub】
第五步：在 PyCharm 中管理项目
1、情况一：下载 GitHub 仓库到本地（Clone）
方式 1：使用 PyCharm Clone
使用 Git 来进行 clone 操作克隆远程仓库:
进入 Github 填入已有仓库的 git 地址：
也可以直接克隆绑定的github中的项目
方式 2：使用终端 Clone
打开终端，进入要存放项目的目录：
cd /path/to/your/local/directory执行 Clone 命令：
git clone git@github.com:your-username/repository.git进入项目文件夹：
cd repository2、情况二：本地修改后上传到 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 你的分支名3、情况三：从 GitHub 拉取最新代码
(1) 在 PyCharm 拉取
右键 项目文件夹 → Git → Pull
选择 要拉取的分支，点击 OK
(2) 使用终端拉取
git pull origin main如果有冲突，Git 会提示你手动合并修改的文件。
4、情况四：创建和切换分支
(1) 创建新分支
git checkout -b 新分支名(2) 切换分支
git checkout 目标分支(3) 合并分支
切换到主分支后，合并其他分支：
git checkout maingit merge 其他分支名
