在 Ubuntu 上使用 PHPStorm 进行 Git 的实操指南
一 环境准备
- 安装 Git：在终端执行以下命令，完成后用 git --version 验证是否安装成功。
sudo apt update
sudo apt install git
git --version
- 配置 Git 全局身份（提交记录会使用该信息）：
git config --global user.name “Your Name”
git config --global user.email “you@example.com”
- 可选：需要较新版本 Git 时，可添加 ppa:git-core/ppa 后安装；或直接从源码编译安装。
二 在 PHPStorm 中配置 Git
- 打开设置：File → Settings（Linux），进入 Version Control → Git。
- 设置 Git 可执行文件路径：在 Path to Git executable 填入 /usr/bin/git，点击 Test 验证；若提示找不到，请确认系统已安装 Git 或调整路径。
- 确认用户信息：Settings → Version Control → Git，核对 User Name 与 User Email 是否正确。
三 常用操作与 IDE 内工作流
- 初始化本地仓库：VCS → Enable Version Control Integration → 选择 Git（项目根目录将生成 .git）。
- 克隆远程仓库：File → New → Project from Version Control → Git，填入仓库 URL 与本地目录，点击 Clone。
- 提交更改：在项目中右键 → Git → Commit Directory，填写提交信息后提交（Commit 仅到本地）。
- 推送与拉取：VCS → Git → Push / Pull；首次推送可设置上游分支（如 git push -u origin main）。
- 分支管理：右下角 Git 分支 按钮可查看/切换/创建/合并分支。
四 常见问题与排查
- 无法识别 Git：Settings → Version Control → Git 中 Test 失败，多为路径错误或 Git 未安装；修正为 /usr/bin/git 或先安装 Git。
- 提交作者信息不正确：在 IDE 的 Git 配置或系统全局配置中核对 user.name / user.email。
- 权限或认证失败：检查远程仓库 HTTPS/SSH 配置、凭据管理器或 SSH 密钥是否已添加到托管平台。
- 需要新版 Git：使用 ppa:git-core/ppa 或源码编译安装后再在 PHPStorm 中测试路径。