PyCharm 集成 Git 版本控制操作指南

一、安装与配置 Git

1. 安装 Git
   • 从 Git 官网 下载并安装适合操作系统的版本。
2. PyCharm 中配置 Git
   • 打开 PyCharm，进入 File → Settings → Version Control → Git，在 Path to Git executable 中选择本地 Git 安装路径（如 git.exe）并测试验证。
3. 配置用户信息（全局）
   • 在终端运行命令：

   git config --global user.name "Your Name"
   git config --global user.email "[email protected]"
   

4. 集成 GitHub（可选）
   • 进入 Settings → Version Control → GitHub，输入 GitHub 账号和密码或 Token 完成认证。
5. SSH 密钥设置
   • 在 CMD 执行指令 ssh-keygen -t ed25519 -C "github 注册的邮箱"，一直按回车 Enter 键。
   • 复制生成的公钥内容，在 GitHub 的 SSH Keys 设置页面粘贴并添加。
   • 在 CMD 执行 ssh -T [email protected]，若显示成功说明配置无误。

二、项目版本控制

1. 初始化仓库

• 新项目：通过 VCS → Import into Version Control → Create Git Repository 初始化本地仓库。
• 现有项目：若远程仓库已存在，通过 VCS → Get from Version Control 克隆项目到本地。

2. 文件操作与提交

• 添加文件：右键文件选择 Git → Add 或直接提交时自动添加。红色文件表示未追踪，绿色为暂存区。
• 提交更改：点击顶部菜单 √ Commit（快捷键 Ctrl+K），填写提交信息后选择 Commit and Push 直接推送至远程仓库。

3. 推送与拉取

• 推送：VCS → Git → Push（快捷键 Ctrl+Shift+K），选择分支推送。
• 拉取更新：VCS → Git → Pull（快捷键 Ctrl+T）同步远程仓库最新代码。

三、分支管理

1. 创建与切换分支

• 右下角点击当前分支名（如 main），选择 New Branch 创建新分支。
• 切换分支：从分支列表中选择目标分支并点击 Checkout。

2. 合并与冲突解决

• 合并分支：切换到目标分支（如 main），右键待合并分支选择 Merge into Current。
• 冲突处理：PyCharm 自动标记冲突文件，通过对比工具手动选择保留内容后提交。

四、高级功能

1. 查看历史记录

• 右键文件或项目选择 Git → Show History，查看提交记录与差异。

2. 忽略文件

• 右键需忽略的文件选择 Git → Add to .gitignore，自动生成忽略规则。

3. 撤销与回退

• 使用 Ctrl+Alt+Z 撤销未提交的修改；通过提交历史右键选择 Reset 回退到指定版本。

五、常见问题

• Git 路径错误：确保在 PyCharm 设置中正确指向 Git 可执行文件，测试通过后生效。
• 推送失败：检查网络连接或远程仓库权限，确保本地分支与远程分支关联。