在PyCharm中使用Git和Gitee进行版本控制的操作流程

一、整体操作流程

先看一张整体流程图，了解一下从创建项目到推送远程仓库的完整脉络。这里面包含了 Git 本地操作和 Gitee 远程交互。

二、环境准备：配置 Git 与 Gitee 插件

2.1 定位 Git 程序

打开 PyCharm，进入 File → Settings → Version Control → Git。在 Path to Git executable 中指定 git.exe 的路径——通常安装 Git 后 PyCharm 会自动识别出来，不过保险起见还是手动确认一下。点一下 Test 按钮，如果显示 Git 版本号，那就说明配置成功了。

2.2 安装 Gitee 插件

PyCharm 默认不直接支持码云，需要手动装个插件。操作很简单：File → Settings → Plugins，搜索 Gitee，找到后点 Install，装完重启 PyCharm 即可。

2.3 关联 Gitee 账号（推荐使用私人令牌）

关联账号时建议用私人令牌，比用户名密码更安全。步骤：File → Settings → Version Control → Gitee，点 Add account，选择 Log in via Token。然后前往 gitee.com → 设置 → 私人令牌 → 生成新令牌，勾选 user_info、projects、pull_requests 等必要权限。生成后复制令牌（注意只能显示一次），粘贴到 PyCharm 中，点 Login 就完成了。备选方式是用用户名和密码（邮箱+密码），但确实不如令牌安全。

三、基本操作：从本地到远程

3.1 初始化本地仓库（git init）

新建一个 Python 项目，然后在菜单里选择 Git，点 OK。项目目录下会多出一个 .git 文件夹，文件颜色变成红色——表示这些文件还没被追踪。

3.2 配置忽略文件（.gitignore）

在与 .git 同级的目录下创建 .gitignore 文件（PyCharm 专业版可以直接右键 → New → File）。常见的忽略项包括：

.idea/
*.iml
__pycache__/
*.pyc
.vscode/

3.3 添加到暂存区（git add）

右键点击项目根目录（或者单个文件）→ Git → Add。文件颜色变成绿色，说明已经进入暂存区，准备提交。

3.4 提交到本地仓库（git commit）

右键项目 → Git → Commit Directory。弹出窗口中，勾选要提交的文件（默认全选），填写 Commit Message（必填）。右下角有两个选项：Commit 只提交到本地，Commit and Push 则提交后直接推送。提交成功后文件颜色恢复为默认的白色或黑色。需要注意的一点：PyCharm 的 Commit 会自动执行 git add，所以不需要先手动 Add 再 Commit。

3.5 关联远程仓库（git remote add）

点击 Git → Manage Remotes，点 + 号，输入 Name（通常用 origin）和 URL（Gitee 仓库的 HTTPS 地址），点 OK 就行。

3.6 推送到远程仓库（git push）

点击 Git → Push，确认本地分支和远程分支（比如 master → origin/master），然后点 Push。首次推送会要求输入 Gitee 账号——如果之前已经用插件登录过，就不会弹框。推送成功后，刷新 Gitee 页面就能看到代码了。

四、分支管理

4.1 创建与切换分支

点击左上角那个显示 main 字样的地方（状态栏），会弹出 Git Branches 菜单。在这里可以创建新分支（New Branch），同时选择是否立刻切换过去。如果想切换到已有分支，在列表里点击分支名，然后选 Checkout 就行了。

4.2 合并分支

假设当前在 main 分支，想把 feature 分支合并进来。先确保 main 是当前分支，然后点击左上角的 main，选择 feature，再点 Merge into Current。如果没有冲突，合并会自动完成，并生成一个合并提交——不需要手动 commit。

4.3 解决冲突

如果两个分支改了同一文件的同一区域，合并时就会弹出冲突提示。PyCharm 会列出所有冲突文件，双击文件打开合并视图：左侧是本地当前分支（Yours），右侧是合并过来的分支（Theirs），中间是结果（Result）。通过 << 或 >> 按钮把需要的代码块合并到结果窗格，也可以手动编辑。调整好之后点 Apply 完成合并，然后提交合并结果——PyCharm 会自动弹出 commit 窗口。

五、从远程拉取与克隆

5.1 拉取远程更新（git pull）

点击 Git → Pull，选择远程仓库和分支（比如 origin/master），然后点 Pull。如果遇到冲突，解决方式和合并冲突一样。

5.2 克隆远程仓库（git clone）

启动 PyCharm 时，选择 Get from VCS（或者主界面点 Git → Clone），在 URL 处填上 Gitee 仓库地址，指定本地目录，点 Clone。PyCharm 会自动执行 git clone，并打开项目。

六、避免冲突的 IDE 操作建议

要减少冲突带来的麻烦，有几点习惯值得养成：

1. 每次修改前先 Pull：快捷键 Ctrl + T 拉取远程最新代码，减少本地落后导致的冲突。
2. 频繁提交并推送：小步提交，每次改动范围小，冲突自然就少。
3. 善用分支：新功能在单独分支上开发，完成后再合并到 master，这样主分支始终稳定。
4. 公共配置文件：在 .gitignore 中忽略本地配置（比如 config.local），避免多人因为同一份配置文件反复冲突。