在 Ubuntu 上完成 PhpStorm 与 Git 的集成
按下面 4 步即可在 Ubuntu 上把 PhpStorm 与 Git 打通，并能在 IDE 内完成提交、推送、拉取与分支管理。
一 准备环境
- 安装 Git（若已安装可跳过）
- 更新索引并安装：sudo apt update && sudo apt install git
- 验证版本：git --version（应输出版本号，如：git version 2.xx.x）
- 配置全局提交身份（与每次提交关联）
- git config --global user.name “Your Name”
- git config --global user.email “you@example.com”
- 查看配置：git config --list
- 可选：需要更新版 Git 时，可使用 PPA 或从源码编译安装（适合对版本有要求的场景）。
二 在 PhpStorm 内配置 Git 路径
- 打开设置：File → Settings（Linux 快捷键：Ctrl+Alt+S）
- 进入 Version Control → Git，在 Path to Git executable 填入 Git 可执行文件路径
- 常见路径：/usr/bin/git（apt 安装）或 /usr/local/bin/git（源码安装）
- 点击右侧 Test 按钮，出现 Git 版本号即表示配置成功
- 若测试失败，请确认 Git 已安装且路径正确，再重试测试。
三 初始化仓库与远程连接
- 初始化本地仓库
- 方式 A（IDE）：VCS → Enable Version Control Integration → 选择 Git
- 方式 B（终端）：在项目根目录执行 git init
- 添加与提交
- 在项目中右键 → Git → Add；随后 Commit（填写提交信息）
- 关联远程仓库
- 方式 A（IDE）：VCS → Git → Remotes → 添加 origin 与仓库 URL
- 方式 B（终端）：git remote add origin
- 推送与拉取
- 推送：VCS → Git → Push（或使用快捷键：Ctrl+Shift+K）
- 拉取：VCS → Git → Pull
- 克隆项目
- 终端：git clone
- 或：VCS → Get from VCS。
四 常用操作与故障排查
- 常用操作
- 提交与推送：在编辑器右上角使用 Commit 与 Push 快捷按钮
- 更新项目：右上角 Update Project（对应 git pull）
- 分支管理：IDE 内提供分支创建、切换、合并与冲突解决入口（VCS/Git 菜单）
- 故障排查
- Path to Git executable 无法识别：确认 Git 安装路径并在 PhpStorm 中重新 Test
- 提交身份异常：检查全局配置 git config --global user.name/email 是否正确
- 需要新版 Git：通过 PPA 或源码编译安装后再在 PhpStorm 中测试路径。
