PHPStorm如何在Ubuntu上使用版本控制

在Ubuntu环境下进行PHP开发，PhpStorm搭配版本控制系统能极大提升工作效率。无论是个人项目还是团队协作，掌握这套工作流都至关重要。下面，我们就来梳理一下在Ubuntu上的PhpStorm中，如何顺畅地使用Git和SVN进行版本控制。

环境准备与 Git 配置

工欲善其事，必先利其器。开始之前，确保你的系统已经准备好了必要的工具。

• 安装 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 路径：接下来，让PhpStorm知道Git在哪里。
  • 打开 File → Settings → Version Control → Git，在 Path to Git executable 一栏填入 /usr/bin/git（如果不确定路径，可以在终端用 which git 命令确认）。
  • 点击 Test 按钮，看到成功的提示就说明配置妥当了。

使用 Git 的完整流程

环境配置好，就可以开始真正的版本控制之旅了。从一个新项目开始，到代码推送到远程仓库，完整的流程是这样的。

• 初始化本地仓库：有两种方式可以创建本地Git仓库，选你顺手的就行。
  • 终端方式：在项目的根目录下，执行 git init。
  • IDE方式：在PhpStorm菜单栏选择 VCS → Initialize Repository，然后选择你的项目根目录。
• 添加与提交：这是日常开发中最频繁的操作。
  • 将文件加入暂存区：在PhpStorm的项目视图中，右键点击文件或目录，选择 Git → Add。或者在提交变更的对话框中直接勾选文件也可以。
  • 提交更改：右键点击项目根目录，选择 Git → Commit Directory，在弹出的窗口中输入清晰的提交信息，然后点击提交。
• 关联远程仓库并推送：想让代码有个安全的“备份”并与他人协作？就需要推送到远程仓库。
  • 先在GitHub、GitLab等代码托管平台创建一个空仓库，并复制其HTTPS或SSH地址。
  • 在PhpStorm中，打开 VCS → Git → Remotes，添加一个名为 origin 的远程仓库，并粘贴上一步复制的URL。
  • 首次推送：在Version Control工具窗口点击Push按钮，首次推送时可以勾选 Set upstream 选项。当然，你也可以在终端使用命令：git push -u origin main（如果默认分支是master，则将main替换为master）。

常用协作操作

在团队中工作，离不开拉取更新、处理分支和解决冲突。

• 获取与更新：
  • 拉取（Pull）：通过 VCS → Git → Pull 获取远程仓库的最新更改并合并到本地。终端命令是 git pull。
  • 推送（Push）：通过 VCS → Git → Push 将本地提交推送到远程仓库。终端命令是 git push。
• 分支与合并：
  • 在PhpStorm窗口的顶部，有一个Git分支控件，你可以很方便地创建新分支、切换分支。开发新功能时，通常在新分支上进行，完成后再合并回主分支（如main或master）。
• 冲突解决：
  • 合并或拉取时如果遇到代码冲突，PhpStorm会醒目地提示冲突文件。双击打开，它会提供一个三方合并工具，让你清晰地对比并决定保留哪部分代码。解决后，将文件标记为已解决状态，然后提交合并结果即可。

使用 SVN 的可选方案

如果你的项目还在使用Subversion（SVN），PhpStorm同样提供了良好的支持。

• 安装与启用：
  • 首先安装SVN客户端：sudo apt-get install subversion
  • 然后在PhpStorm中安装插件：打开 File → Settings → Plugins，搜索并安装 Subversion Integration 插件，安装后重启IDE。
• 配置路径：
  • 打开 File → Settings → Version Control → Subversion，设置 Path to Subversion executable（通常是 /usr/bin/svn），同样点击 Test 验证。
• 基本操作：
  • 检出（Checkout）：通过 VCS → Checkout from Version Control → Subversion，输入仓库URL和本地存放目录。
  • 提交与更新：使用 VCS → Commit 提交本地修改，使用 VCS → Update Project 来更新你的工作副本到最新版本。

常见问题与排查

即使流程再清晰，也难免会遇到一些小麻烦。这里有几个常见问题的排查思路。

• Git 路径无效：检查设置中的路径 /usr/bin/git 是否存在且可执行。如果不行，尝试重新安装Git并重启PhpStorm。
• 首次推送被拒绝：确认是否已经正确关联了远程仓库（origin）。如果远程仓库已有内容（比如README文件），你需要先执行 git pull --rebase 将远程更改合并到本地，然后再推送。
• 权限失败（SSH）：如果使用SSH方式推送失败，请确保你的公钥（~/.ssh/id_rsa.pub）已经添加到了托管平台的SSH Keys设置中。或者，可以暂时切换使用HTTPS方式，并在提示时输入用户名和密码（或个人访问令牌）。
• 提交作者信息错误：如果提交记录显示的作者信息不对，可以用 git config --global user.name/email 命令修正全局配置。或者在PhpStorm的提交对话框中，临时覆盖本次提交的作者信息。