企业官网建设流程全解析

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/Linux：File→Settings（或快捷键Ctrl + Alt + S）
• macOS：PyCharm→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 仓库

1. 创建新项目：File→New Project
2. 勾选 Git 选项：在创建项目窗口底部，勾选Create Git repository
3. 选择解释器，点击Create

这样创建的项目会自动初始化 Git 仓库。

2.2 为已有项目添加 Git

1. 打开项目：File→Open，选择你的项目文件夹
2. 初始化 Git：顶部菜单VCS→Enable Version Control Integration...
3. 选择Git，点击OK

或者直接在终端执行：

gitinit

初始化成功后，PyCharm 右下角会出现Git分支指示器。

第三步：第一次提交代码

3.1 理解 Git 工作流

工作目录 → 暂存区 → 本地仓库 (写代码) (git add) (git commit)

PyCharm 让这个过程变得超级简单。

3.2 查看文件状态

创建或修改文件后，PyCharm 会用颜色标记文件状态：

3.3 打开提交界面

方法一：快捷键提交（推荐）

• Windows/Linux：Ctrl + K
• macOS：Cmd + K

方法二：菜单提交

• VCS→Commit...

方法三：工具栏提交

• 点击工具栏的绿色勾号 ✅ 图标

3.4 Commit 操作步骤

按下Ctrl + K后，会打开 Commit 面板：

1. 选择要提交的文件：在Changes区域勾选文件
2. 查看改动：点击文件名，右侧会显示代码差异对比
3. 填写提交信息：在Commit Message框写清楚这次改了什么
4. 提交：点击Commit按钮（或Commit and Push直接推送）

提交信息怎么写？

feat: 添加用户登录功能 fix: 修复列表页加载异常 docs: 更新README安装说明

💡好习惯：每次提交只做一件事，提交信息要清晰易懂。

第四步：分支管理（实用的进阶操作）

4.1 什么是分支？

分支让你可以在不影响主线的情况下，开发新功能或修 Bug。开发完成后再合并回主线。

4.2 创建分支

方式一：右下角

点击右下角分支名 →New Branch，输入分支名即可。

方式二：终端命令

gitbranch 新功能名

4.3 切换分支

直接点击右下角分支名称，弹出列表选择要切换的分支。

4.4 合并分支

假设要把feature-login合并到master：

1. 先切换到master（点击右下角切换）
2. 菜单：VCS→Git→Merge Changes...
3. 选择feature-login分支
4. 点击Merge

有冲突时，PyCharm 会弹出冲突解决窗口，可视化处理非常方便。

第五步：连接 GitHub（远程仓库）

5.1 在 GitHub 创建仓库

1. 打开 github.com，登录后点击+→New repository
2. 填写仓库名（和项目名一致）
3. 不要勾选“Add a README file”（本地已有）
4. 点击Create repository

5.2 关联远程仓库

复制仓库链接（HTTPS 格式）：

https://github.com/你的用户名/仓库名.git

在 PyCharm 终端执行：

gitremoteaddorigin 你的仓库链接gitbranch-Mmastergitpush-uorigin master

5.3 使用 PyCharm 推送

后续推送代码更简单：

• 快捷键：Ctrl + Shift + K(Windows/Linux) 或Cmd + Shift + K(macOS)
• 菜单：VCS→Git→Push...
• 确认后点击Push

5.4 首次推送可能需要登录

• 方式一：使用 GitHub 账号密码 + Personal Access Token
• 方式二（推荐）：PyCharm 会引导你通过浏览器登录 GitHub 授权

第六步：常用操作速查表

第七步：查看 Git 历史

打开 Git 工具窗口（快捷键Alt + 9/Cmd + 9），你可以看到：

• 📜提交历史：谁在什么时候改了什么
• 🔍每次提交的详细改动
• 🌿分支图：分支的创建与合并一目了然

常见问题排查

Q1：PyCharm 提示 “Git is not installed”

解决：到 git-scm.com 下载安装 Git，重启 PyCharm

Q2：提交时提示 “Please tell me who you are”

解决：回到第一步配置git config --global user.name和user.email

Q3：Push 失败 “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+ 版本。如有更新或问题，欢迎在评论区交流。