PyCharm中如何使用Git进行协作开发

PyCharm 中使用 Git 进行协作开发

环境与账号准备

• 安装并配置 Git：在系统安装 Git，并在 PyCharm → Settings/Preferences → Version Control → Git 中设置 Git 可执行文件路径，点击 Test 验证版本。
• 配置 GitHub 账号：在 Settings/Preferences → Version Control → GitHub 添加账号。若使用密码认证失败，请在 GitHub 生成 Personal Access Token（路径：Settings → Developer settings → Tokens（classic）→ Generate new token），复制并粘贴到 PyCharm 登录。
• 推荐配置 SSH：生成密钥（如 ssh-keygen -t rsa -C "email"），将公钥添加到 GitHub → SSH keys，在 PyCharm 使用 SSH 远程地址可免重复登录。

仓库获取与初始设置

• 克隆仓库：在欢迎页选择 Get from VCS，填入仓库 URL（SSH 或 HTTPS），选择本地目录后克隆。
• 或分享项目到 GitHub：在已有项目中选择 VCS → Import into Version Control → Share Project on GitHub，填写仓库名并 Share。
• 忽略文件：创建或完善 .gitignore（如忽略 .idea/、.iml、pycache、.env、venv/、.log 等），避免提交无关或敏感文件。

日常协作流程

• 分支策略：保持 main/master 稳定用于发布，日常在 dev 集成，个人在 feature/xxx 或 dev_姓名 分支开发。
• 开发步骤：
  1. 在右下角 Git → New Branch 创建并切换到个人分支；
  2. 编码后 Commit（首次新增文件需先 Add），填写清晰的提交信息；
  3. Push 将本地分支推送到远程同名分支；
  4. 同步上游：切到 dev 分支，先 Pull 拉取最新代码，再 Pull Rebase 个人分支（或在本地合并个人分支到 dev），如有冲突按提示解决；
  5. 将 dev 推送到远程，保持远程 dev 为最新集成分支。
• 提交与推送顺序：务必先 Commit（本地）再 Push（远程）；若远程已有更新，先 Pull 再推送，避免非必要冲突。

合并与冲突解决

• 合并方式：在 Git → Branches 中切到目标分支（如 dev），选择 Merge 将功能分支合入；或使用 Pull Request 在 GitHub 上评审后合并。
• 冲突处理：冲突文件会被标记，双击打开 Merge/Conflict Resolution 工具，使用 >>/<< 选择保留或合并两侧更改，保存后标记为已解决，再 Commit 并完成 Push。
• 经验建议：小步提交、频繁同步（勤 Pull）、合并前运行本地测试，降低冲突与回滚成本。

权限与协作模式

• 添加协作者：仓库 Settings → Collaborators 添加成员邮箱，对方接受邀请后获得 读写权限，可直接 push/pull 到受邀请的仓库。
• 身份验证：推送时若被要求登录，使用 GitHub Token 或配置 SSH 完成认证。
• 版本线策略：日常在 dev 集成，发布时由维护者将 dev 合并入 main/master；个人分支定期清理，避免长期分叉。