在 Linux 中使用 PhpStorm 进行版本控制
一 环境准备
- 安装 Git：在 Debian/Ubuntu 等发行版执行：
sudo apt update && sudo apt install git，完成后用 git --version 验证。
- 配置 Git 身份：设置全局用户名与邮箱，便于提交记录归属。
- 以上完成后即可在 PhpStorm 内使用 Git 的各项功能。
二 在 PhpStorm 中配置 Git
- 打开设置：依次点击 File → Settings → Version Control → Git（macOS 为 Preferences）。
- 指定 Git 可执行文件路径：在 Path to Git executable 填入 /usr/bin/git，点击 Test 验证是否可用。
- 配置用户信息：在设置中填写 User name 与 Email（或使用命令行全局配置，二选一即可）。
- 以上配置完成后，PhpStorm 即可调用系统 Git 完成版本控制操作。
三 常用版本控制操作
- 初始化或启用版本控制：打开项目后，依次点击 VCS → Enable Version Control Integration，选择 Git。
- 克隆远程仓库：依次点击 File → New → Project from Version Control → Git，填入仓库 URL 与本地目录，点击 Clone。
- 提交更改：在 Version Control 面板中右键项目或文件，选择 Git → Commit Directory（或 Commit），填写提交信息后提交到本地。
- 推送与拉取：提交后使用 Git → Repository → Push 推送到远程；获取更新使用 VCS → Pull Changes。
- 分支管理：点击界面右下角的 Git 分支 按钮，可进行 切换/新建/合并/检出远程分支 等操作。
四 远程仓库与认证配置
- 添加远程地址：在 Version Control → Git → Remotes 中添加远程仓库 URL（如：
https://github.com/username/repo.git）。
- 认证方式：
- HTTPS：首次推送可能弹出凭据输入框，或使用 Personal Access Token 代替密码。
- SSH：将本地 ~/.ssh/id_rsa.pub 公钥添加到 GitHub/GitLab，然后在 PhpStorm 中使用 SSH 地址克隆/推送。
- 推送与拉取：完成远程与认证配置后，即可在 PhpStorm 中执行 Push/Pull 与分支同步。
五 常见问题排查
- Git 路径无效：确认 /usr/bin/git 存在且可执行，必要时在设置中重新指定并重试 Test。
- 提交无作者信息：执行
git config --global user.name "Your Name" 与 git config --global user.email "you@example.com" 后重启 IDE。
- 无法连接远程仓库：检查 Remotes 地址是否正确、网络与 SSH/HTTPS 认证是否配置成功。
- 分支操作失败：先执行 Pull 同步远程变更，再合并/推送，避免非快进冲突。
