PyCharm项目上传GitHub仓库（笔记）

前言

本文总结如何将PyCharm中的本地项目上传至个人GitHub仓库，步骤清晰且覆盖关键配置点，适用于Git/GitHub新手。

一、工具准备：安装并了解Git

1. Git工具说明

Git是开源的分布式版本控制系统，用于高效管理项目代码版本、支持多人协作开发，由Linux内核开发者Linus Torvalds于2005年开发，核心优势是"快速、高效，适配大型项目"。

2. Git安装指引

需提前安装Git（后续PyCharm需关联Git可执行文件），详细安装与配置步骤可参考git的安装与配置教程-超详细版。

二、详细操作步骤（4步完成上传）

步骤1：在PyCharm中配置Git

目标：让PyCharm识别并关联本地Git工具，创建项目的Git仓库。

1. 打开PyCharm，加载需要上传的本地项目；
2. 进入Git配置界面：点击顶部菜单栏 文件(F) → 设置(T) （快捷键Ctrl+Alt+S）；
3. 关联Git可执行文件：
   • 在设置窗口左侧找到 版本控制 → Git；
   • 在"Git可执行文件路径§"处，选择本地Git安装目录下的git.exe（示例路径：D:\Git\Git\bin\git.exe）；
   • 点击"测试"，若显示Git版本号（如2.42.0），说明配置成功；
4. 创建项目Git仓库：
   • 点击顶部菜单栏 VCS(S) → 启用版本控制集成(E)... → 选择Git；
   • 建议仓库地址与当前PyCharm项目路径一致（避免后续路径混乱）。

步骤2：在GitHub上创建空白仓库

目标：创建一个用于接收PyCharm项目的远程仓库，并获取仓库链接。

1. 登录GitHub首页，点击右上角 New（新建仓库）；
2. 填写仓库基础信息（带*为必填）：
   • Repository name（仓库名）：建议简短易记（示例：test，需确认"is available"表示未被占用）；
   • Description（描述）：可选，填写项目简介；
   • Visibility（可见性） ：选Public（公开，所有人可查看）或Private（私有，仅指定人可访问）；
   • 初始化选项 （可选，新手建议简化）：
     • 暂不勾选"Add a README file""Add .gitignore""Choose a license"（后续可在本地补充）；
3. 点击 Create repository 完成创建；
4. 复制仓库HTTPS链接：创建后在仓库页面找到"Quick setup"，选择HTTPS协议，点击链接右侧的"复制"按钮（示例链接：https://github.com/用户名/test.git）。

步骤3：在PyCharm中配置GitHub远程链接

目标：将PyCharm本地项目与GitHub新建仓库关联，建立"本地→远程"的传输通道。

1. 再次进入PyCharm设置：文件(F) → 设置(T) → 版本控制 → GitHub；
2. 登录GitHub账号：点击右侧"+"号，选择"通过GitHub登录"（按弹窗提示完成授权，确保账号有权操作目标仓库）；
3. 配置远程仓库：
   • 点击顶部菜单栏 Git(G) → 管理远程...；
   • 在"Git 远程"窗口点击"+"，设置：
     • 名称 ：默认填origin（Git默认远程仓库名，便于后续操作）；
     • URL：粘贴步骤2中复制的GitHub仓库HTTPS链接；
   • 点击"确定"保存配置。

步骤4：提交并上传项目到GitHub

目标：将本地项目文件同步到远程GitHub仓库，完成最终上传。

1. 提交本地文件（将文件纳入Git版本控制）：
   • 点击顶部菜单栏 Git(G) → 提交(I)... （快捷键Ctrl+K）；
   • 在"提交"窗口勾选需要上传的文件（无需上传的文件取消勾选，如临时日志文件）；
     • 注意：.idea文件夹（PyCharm项目配置）、.gitignore（Git忽略规则文件）可根据需求选择是否上传；
   • 在"提交信息"框填写描述（如"首次提交项目"，便于后续追溯版本）；
   • 点击"提交"（若想直接上传，可点击"提交并推送§..."）。
2. 推送文件到GitHub（将本地提交同步到远程）：
   • 点击顶部菜单栏 Git(G) → 推送... （快捷键Ctrl+Shift+K）；
   • 在"将提交推送到"窗口，确认：
     • 分支：默认master或main（与GitHub仓库默认分支一致）；
     • 远程仓库：origin（步骤3配置的远程名）；
   • 点击"推送§"，等待同步完成（若首次推送，可能需输入GitHub账号密码或验证码授权）。
3. 验证结果：打开GitHub目标仓库页面，点击"刷新"，若能看到PyCharm中的项目文件（如demo.py、user_information_extraction.py），说明上传成功。

三、补充说明（扩展场景）

• 上传Gitee仓库 ：操作逻辑与GitHub完全一致，仅需替换2个步骤：
  1. 在Gitee首页新建空白仓库，复制其HTTPS链接；
  2. 步骤3中"URL"粘贴Gitee仓库链接，后续提交、推送步骤不变。
• 常见问题 ：若推送失败，可检查：
  • Git配置路径是否正确（步骤1"测试"是否显示版本号）；
  • 远程链接是否有误（步骤3 URL是否与GitHub/Gitee仓库链接一致）；
  • GitHub账号是否有权限操作该仓库（步骤3登录账号是否为仓库所有者或协作者）。