在 CentOS 上使用 PhpStorm 进行 Git 版本控制
一 环境准备
- 安装 Git：在终端执行以下任一命令（根据你的系统选择）
- CentOS 7/8：
sudo yum install git -y
- CentOS 8+（或 Stream）：
sudo dnf install git -y
- 验证安装：
git --version
- 配置全局用户信息（提交者身份）
git config --global user.name "Your Name"git config --global user.email "you@example.com"
- 如需使用 SSH 拉取/推送（推荐）
- 生成密钥：
ssh-keygen -t rsa -b 4096 -C "you@example.com"（默认保存到 ~/.ssh/id_rsa）
- 将公钥 ~/.ssh/id_rsa.pub 添加到 GitHub/Gitee/GitLab 的 SSH Keys
- 验证连接：
ssh -T git@github.com（首次会提示确认指纹，看到 “Hi xxx” 即成功）
二 在 PhpStorm 中配置 Git
- 打开设置：File → Settings（macOS 为 Preferences）→ Version Control → Git
- 设置 Git 可执行文件路径：Path to Git executable 填写 /usr/bin/git，点击 Test 验证
- 确认用户信息：在设置中填写 User Name 与 User Email（与
git config --global 一致）
- 以上完成后，PhpStorm 即可调用系统 Git 完成版本控制操作
三 常用操作一 克隆与初始化
- 克隆远程仓库
- VCS → Get from VCS（或 VCS → Git → Clone），输入仓库 URL（HTTPS 或 SSH），选择本地目录后 Clone
- 在现有项目启用版本控制
- VCS → Enable Version Control Integration，选择 Git
- 初始化本地仓库
- 项目根目录右键 → Git → Initialize Repository（等效命令：
git init）
- 添加远程仓库
- VCS → Git → Remotes → +，Name 填 origin，URL 填仓库地址（HTTPS/SSH）
四 常用操作二 提交 推送 拉取 与分支
- 提交更改
- 右侧 Commit 工具窗口选择变更文件，填写提交信息，点击 Commit 或 Commit and Push
- 推送与拉取
- 工具栏 Push（推送当前分支到 origin）与 Pull（从 origin 拉取并合并）
- 分支管理
- 右下角 Git 分支弹窗：New Branch 创建；Checkout 切换；Merge 合并；Delete 删除
- 冲突解决
- 拉取或合并发生冲突时，PhpStorm 会标记冲突文件；打开文件手动编辑，使用 Accept Yours / Accept Theirs / Merge 解决后标记为已解决，再 Commit 与 Push
五 常见问题与排查
- Git 路径错误：Settings → Version Control → Git 中确认 /usr/bin/git 并 Test；若提示找不到，检查是否安装 Git 或路径是否被自定义
- 认证失败
- HTTPS：检查账号令牌/密码是否正确（GitHub 已弃用密码，需使用 Personal Access Token）
- SSH：确认公钥已添加到托管平台，且本地使用 ssh -T 测试通过
- 无法识别为 Git 项目：VCS → Enable Version Control Integration 选择 Git；或项目根目录执行
git init 后重新打开项目
- 权限或 SELinux 问题：确保项目目录对当前用户可写；如启用 SELinux，必要时调整上下文或临时设为宽松模式以排查（生产环境请按策略配置）