在 Debian 上配置 PhpStorm 使用 Git 版本控制
一 环境准备
- 安装 Git：在终端执行以下命令，完成后用 git --version 验证是否安装成功。
sudo apt update
sudo apt install git
- 配置全局用户名与邮箱（用于提交记录）：
git config --global user.name “Your Name”
git config --global user.email “your_email@example.com”
以上完成后，系统已具备 Git 环境，可在 PhpStorm 内直接使用。
二 在 PhpStorm 内配置 Git
- 打开设置：File > Settings（Linux），进入 Version Control > Git。
- 指定 Git 可执行文件路径：在 Path to Git executable 填写 /usr/bin/git，点击 Test 确认识别成功。
- 如需使用 GitHub 账号进行托管与操作，可在 VCS > Enable Version Control Integration 后选择 GitHub 按向导登录并绑定账户。
上述配置完成后，PhpStorm 即可调用系统 Git 完成版本控制操作。
三 常用版本控制操作
- 克隆仓库：File > New > Project from Version Control > Git，输入远程仓库 URL 与目标路径，点击 Clone。
- 初始化本地仓库：VCS > Enable Version Control Integration，选择 Git（或项目右键 Git > Init Repository），会在项目根目录生成 .git。
- 提交与推送：在提交窗口勾选要提交的文件，填写提交信息后执行 Commit；随后通过 VCS > Git > Push 推送到远程分支。
- 拉取更新：通过 VCS > Git > Pull 获取远程变更。
- 分支管理：通过界面右下角的 Git 分支 按钮进行新建、切换、合并与删除分支。
以上流程覆盖日常开发中最常用的提交、推送、拉取与分支协作。
四 常见问题与排查
- Git 路径未识别：确认 /usr/bin/git 存在且可执行，必要时在设置中手动指定并重试 Test。
- 提交时报错“user.name/email 未配置”：在项目根目录或全局执行 git config 设置用户名与邮箱后重试。
- 无法连接 GitHub：在 VCS > GitHub 中重新登录，或检查网络与代理设置。
- 合并冲突处理：冲突文件会高亮显示，使用 PhpStorm 内置的冲突解决工具进行编辑与标记解决，然后提交。
以上为高频问题与处理建议，可快速定位并恢复正常工作流。
