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);
    • 在"将提交推送到"窗口,确认:
      • 分支:默认mastermain(与GitHub仓库默认分支一致);
      • 远程仓库:origin(步骤3配置的远程名);
    • 点击"推送§",等待同步完成(若首次推送,可能需输入GitHub账号密码或验证码授权)。
  3. 验证结果:打开GitHub目标仓库页面,点击"刷新",若能看到PyCharm中的项目文件(如demo.pyuser_information_extraction.py),说明上传成功。

三、补充说明(扩展场景)

  • 上传Gitee仓库 :操作逻辑与GitHub完全一致,仅需替换2个步骤:
    1. 在Gitee首页新建空白仓库,复制其HTTPS链接;
    2. 步骤3中"URL"粘贴Gitee仓库链接,后续提交、推送步骤不变。
  • 常见问题 :若推送失败,可检查:
    • Git配置路径是否正确(步骤1"测试"是否显示版本号);
    • 远程链接是否有误(步骤3 URL是否与GitHub/Gitee仓库链接一致);
    • GitHub账号是否有权限操作该仓库(步骤3登录账号是否为仓库所有者或协作者)。
相关推荐
聪明的笨猪猪18 小时前
Java 内存模型(JMM)面试清单(含超通俗生活案例与深度理解)
java·经验分享·笔记·面试
想唱rap20 小时前
Linux指令(1)
linux·运维·服务器·笔记·新浪微博
Predestination王瀞潞20 小时前
Github卡顿问题解决方案
github·解决方案
东方芷兰20 小时前
LLM 笔记 —— 02 大语言模型能力评定
人工智能·笔记·python·神经网络·语言模型·自然语言处理·cnn
71-31 天前
C语言——循环的嵌套小练习
c语言·笔记·学习·其他
东方芷兰1 天前
LLM 笔记 —— 03 大语言模型安全性评定
人工智能·笔记·python·语言模型·自然语言处理·nlp·gpt-3
悠哉悠哉愿意1 天前
【ROS2学习笔记】Gazebo 仿真与 XACRO 模型
笔记·学习·机器人·ros2
悠哉悠哉愿意1 天前
【ROS2学习笔记】节点篇:ROS 2编程基础
笔记·学习·ros2
我命由我123451 天前
Photoshop - Photoshop 工具栏(2)矩形框选工具
经验分享·笔记·学习·ui·photoshop·ps·美工
序属秋秋秋1 天前
《C++进阶之C++11》【异常】
c++·笔记·学习·c++11·异常·新特性