Ubuntu下 PhpStorm 版本控制设置指南
一 前置准备
- 安装 Git：在终端执行命令：sudo apt update && sudo apt install git。
- 配置全局身份：设置用户名与邮箱（将引号内替换为你的信息）：git config --global user.name “Your Name”，git config --global user.email “you@example.com”。
- 验证安装：执行 git --version，应输出版本号；如需确认身份配置，执行 git config --global --list。
以上步骤完成后，Ubuntu 环境即可与 PhpStorm 的 Git 集成正常配合。
二 在 PhpStorm 内配置 Git
- 打开设置：进入 File → Settings（快捷键 Ctrl+Alt+S），定位到 Version Control → Git。
- 指定 Git 可执行文件路径：在 Path to Git executable 填入 /usr/bin/git（如使用系统包管理器安装，通常即为此路径）。
- 测试 Git：点击右侧 Test 按钮，看到版本号即表示集成成功。
- 全局用户信息：如需在 IDE 内统一提交者信息，可在设置中的 Version Control → Git → Committer 填写 Name 与 Email（与 Git 全局配置保持一致可减少混淆）。
三 初始化仓库与基本操作
- 将项目纳入版本控制：在 PhpStorm 菜单选择 VCS → Enable Version Control Integration，在弹出框中选择 Git；或在项目根目录执行终端命令 git init。
- 添加与提交：在项目中右键文件/目录选择 Git → Add，随后通过 Commit（或 Commit Directory）输入提交信息完成提交。
- 查看与对比：使用 Version Control 工具窗口查看 Unversioned/Modified/Staged 状态，支持文件差异对比与历史记录查看。
- 推送与拉取：在工具栏或 VCS → Git 菜单执行 Push/Pull；首次推送可设置上游分支（例如将本地 master/main 推送到 origin/master/main）。
四 连接远程仓库
- 新建远程仓库：在 GitHub/GitLab/Gitee 等平台创建空仓库，获取 HTTPS/SSH 地址。
- 添加远程地址：
- 图形界面：在 VCS → Git → Remotes 中点击 +，填写名称（通常为 origin）与仓库 URL。
- 命令行：在项目根目录执行 git remote add origin <repository_url>。
- 推送代码：执行 git push -u origin master（或 main），后续可直接 git push。
- 认证方式：
- HTTPS：首次推送会弹出账号口令或浏览器登录。
- SSH：需提前将本地 SSH 公钥 添加到托管平台的 SSH Keys 中，之后即可免密推送/拉取。
五 常见问题与排查
- Git 路径无效：确认 /usr/bin/git 存在且可执行；若自定义安装，请在 Path to Git executable 中指向实际路径，并通过 Test 验证。
- 提交者信息不一致：检查 git config --global user.name/email 与 IDE 中 Committer 设置是否一致，避免提交记录显示异常。
- 无法连接远程仓库：核对远程 URL、分支名（master/main）与认证方式（HTTPS/SSH）；必要时使用命令行先行验证连通性。
- 权限或认证失败：SSH 请确保公钥已添加；HTTPS 请确认凭据正确或使用凭据助手保存。
- 界面找不到 VCS 菜单：可能项目未启用版本控制，先执行 VCS → Enable Version Control Integration 选择 Git。