在 Ubuntu 上使用 PhpStorm 进行版本控制
一 环境准备与 Git 配置
- 安装 Git：在终端执行以下命令安装并验证版本。
- sudo apt-get update
- sudo apt-get install git
- git --version
- 配置全局身份（用于提交记录）：
- git config --global user.name “Your Name”
- git config --global user.email “you@example.com”
- 在 PhpStorm 中设置 Git 路径：
- 打开 File → Settings → Version Control → Git，将 Path to Git executable 设为 /usr/bin/git（可使用 which git 确认路径）。
- 点击 Test 验证是否可用。
二 使用 Git 的完整流程
- 初始化本地仓库（两种方式任选其一）：
- 终端：在项目根目录执行 git init。
- IDE：在 PhpStorm 菜单 VCS → Initialize Repository，选择项目根目录。
- 添加与提交：
- 将文件加入暂存：在项目视图中右键文件/目录选择 Git → Add，或在提交对话框中勾选变更文件。
- 提交更改：右键项目根目录选择 Git → Commit Directory，输入提交信息后提交。
- 关联远程仓库并推送：
- 在托管平台（如 GitHub/GitLab）创建空仓库，复制仓库 HTTPS/SSH 地址。
- IDE：打开 VCS → Git → Remotes，添加远程 origin 与仓库 URL。
- 推送：在 Version Control 工具窗口点击 Push，首次推送可勾选 Set upstream；或使用命令行 git push -u origin main（若默认分支为 master，则使用 master）。
三 常用协作操作
- 获取与更新：
- 拉取：VCS → Git → Pull（或使用终端 git pull）。
- 推送：VCS → Git → Push（或使用终端 git push）。
- 分支与合并：
- 在窗口顶部 Git 分支控件创建/切换分支，完成功能后合并到主干。
- 冲突解决：
- 合并或拉取出现冲突时，PhpStorm 会提示冲突文件，打开 Merge 工具进行三方合并，保存后标记为已解决并提交。
四 使用 SVN 的可选方案
- 安装与启用：
- 安装 SVN：sudo apt-get install subversion
- 在 File → Settings → Plugins 安装 Subversion Integration 插件并重启 IDE。
- 配置路径：
- File → Settings → Version Control → Subversion，设置 Path to Subversion executable（通常为 /usr/bin/svn），点击 Test 验证。
- 基本操作：
- 检出：VCS → Checkout from Version Control → Subversion，输入仓库 URL 与本地目录。
- 提交与更新：使用 VCS → Commit 提交变更，使用 VCS → Update Project 更新工作副本。
五 常见问题与排查
- Git 路径无效：在设置中确认 /usr/bin/git 存在且可执行，必要时重装 Git 并重启 PhpStorm。
- 首次推送被拒绝：确认已关联远程 origin，并使用 git push -u origin main/master；若远程已有提交，先 git pull --rebase 再推送。
- 权限失败（SSH）：确保 ~/.ssh/id_rsa.pub 已添加到托管平台的 SSH Keys，或使用 HTTPS 并在提示中输入凭证。
- 提交作者信息错误：使用 git config --global user.name/email 修正全局配置，或在提交对话框中临时覆盖。