Git 初次在 PyCharm 使用完全指南 目标读者第一次在 PyCharm 中使用 Git 的开发者前置要求已安装 PyCharm 和 Git你将学会配置 Git → 创建仓库 → 提交代码 → 分支管理 → 连接 GitHub目录为什么要在 PyCharm 中使用 Git第一步检查 Git 配置第二步创建或打开项目第三步第一次提交代码第四步分支管理第五步连接 GitHub远程仓库第六步常用操作速查表第七步查看 Git 历史常见问题排查总结你学会了什么为什么要在 PyCharm 中使用 Git作为 Python 开发者PyCharm 是我们最常用的 IDE。将 Git 集成到 PyCharm 中你可以✅不用离开编辑器就能完成版本控制操作✅图形化界面让 Git 操作更直观降低学习成本✅可视化差异对比改了什么一目了然✅一键回滚再也不怕代码改崩了第一步检查 Git 配置在开始前确保 PyCharm 已经识别到 Git。1.1 打开设置Windows/LinuxFile→Settings或快捷键Ctrl Alt SmacOSPyCharm→Preferences或快捷键Cmd ,1.2 找到 Git 设置导航到Version Control→Git在Path to Git executable中点击Test按钮如果显示 Git 版本信息如git version 2.39.0说明配置成功 ✅如果报错需要手动指定 Git 安装路径1.3 配置用户信息这是你第一次使用 Git 的必要步骤用于标识代码提交者。在 PyCharm 终端View→Tool Windows→Terminal中输入gitconfig--globaluser.name你的用户名gitconfig--globaluser.email你的邮箱提示建议使用 GitHub 相同的用户名和邮箱这样提交记录能正确关联到你的 GitHub 账号。第二步创建或打开项目2.1 新建项目时同时创建 Git 仓库创建新项目File→New Project勾选 Git 选项在创建项目窗口底部勾选Create Git repository选择解释器点击Create这样创建的项目会自动初始化 Git 仓库。2.2 为已有项目添加 Git打开项目File→Open选择你的项目文件夹初始化 Git顶部菜单VCS→Enable Version Control Integration...选择Git点击OK或者直接在终端执行gitinit初始化成功后PyCharm 右下角会出现Git分支指示器。第三步第一次提交代码3.1 理解 Git 工作流工作目录 → 暂存区 → 本地仓库 (写代码) (git add) (git commit)PyCharm 让这个过程变得超级简单。3.2 查看文件状态创建或修改文件后PyCharm 会用颜色标记文件状态文件颜色Git 状态说明绿色新增文件还没加入 Git 管理蓝色已修改文件有改动未提交⚪白色未改变和上次提交一样红色未加入版本控制新建但未git add3.3 打开提交界面方法一快捷键提交推荐Windows/LinuxCtrl KmacOSCmd K方法二菜单提交VCS→Commit...方法三工具栏提交点击工具栏的绿色勾号 ✅ 图标3.4 Commit 操作步骤按下Ctrl K后会打开 Commit 面板选择要提交的文件在Changes区域勾选文件查看改动点击文件名右侧会显示代码差异对比填写提交信息在Commit Message框写清楚这次改了什么提交点击Commit按钮或Commit and Push直接推送提交信息怎么写feat: 添加用户登录功能 fix: 修复列表页加载异常 docs: 更新README安装说明好习惯每次提交只做一件事提交信息要清晰易懂。第四步分支管理实用的进阶操作4.1 什么是分支分支让你可以在不影响主线的情况下开发新功能或修 Bug。开发完成后再合并回主线。4.2 创建分支方式一右下角点击右下角分支名 →New Branch输入分支名即可。方式二终端命令gitbranch 新功能名4.3 切换分支直接点击右下角分支名称弹出列表选择要切换的分支。4.4 合并分支假设要把feature-login合并到master先切换到master点击右下角切换菜单VCS→Git→Merge Changes...选择feature-login分支点击Merge有冲突时PyCharm 会弹出冲突解决窗口可视化处理非常方便。第五步连接 GitHub远程仓库5.1 在 GitHub 创建仓库打开 github.com登录后点击→New repository填写仓库名和项目名一致不要勾选“Add a README file”本地已有点击Create repository5.2 关联远程仓库复制仓库链接HTTPS 格式https://github.com/你的用户名/仓库名.git在 PyCharm 终端执行gitremoteaddorigin 你的仓库链接gitbranch-Mmastergitpush-uorigin master5.3 使用 PyCharm 推送后续推送代码更简单快捷键Ctrl Shift K(Windows/Linux) 或Cmd Shift K(macOS)菜单VCS→Git→Push...确认后点击Push5.4 首次推送可能需要登录方式一使用 GitHub 账号密码 Personal Access Token方式二推荐PyCharm 会引导你通过浏览器登录 GitHub 授权第六步常用操作速查表操作快捷键Win/Linux快捷键Mac菜单路径提交代码Ctrl KCmd KVCS → Commit推送代码Ctrl Shift KCmd Shift KVCS → Git → Push拉取代码Ctrl TCmd TVCS → Git → Pull查看历史Alt 9Cmd 9View → Tool Windows → Git回滚文件--右键文件 → Git → Rollback第七步查看 Git 历史打开 Git 工具窗口快捷键Alt 9/Cmd 9你可以看到提交历史谁在什么时候改了什么每次提交的详细改动分支图分支的创建与合并一目了然常见问题排查Q1PyCharm 提示 “Git is not installed”解决到 git-scm.com 下载安装 Git重启 PyCharmQ2提交时提示 “Please tell me who you are”解决回到第一步配置git config --global user.name和user.emailQ3Push 失败 “Authentication failed”解决去 GitHub → Settings → Developer settings → Personal access tokens 创建 Token用 Token 代替密码登录Q4不小心git init到了桌面怎么删除解决显示隐藏文件夹删除.git文件夹即可不会删掉你的文件Q5我怎么知道现在在哪个分支答案看 PyCharm 右下角的分支名或终端git branch带*的分支总结你学会了什么完成这篇指南后你已经掌握了✅ 在 PyCharm 中配置 Git✅ 创建仓库和提交代码✅ 使用分支开发新功能✅ 连接 GitHub 远程仓库✅ 使用可视化工具解决冲突✅ 利用快捷键提升效率下一步建议尝试和同学合作一个项目练习Pull Request流程学习.gitignore文件忽略不需要提交的文件如__pycache__、.idea等探索 PyCharm 的Shelve功能暂存临时修改记住Git 是程序员的基本功多练多用就会越来越熟练。第一次不完美没关系重要的是养成先提交、再推送的习惯文章信息本文面向 Git 初学者假定环境为 PyCharm 2023 版本。如有更新或问题欢迎在评论区交流。