Ubuntu下 PhpStorm 版本控制设置指南

一 前置准备

在开始之前，咱们得先把基础环境搭好。这事儿不复杂，按部就班来就行。

• 安装 Git：打开终端，执行这条命令：sudo apt update && sudo apt install git。它会先更新软件包列表，然后安装Git。
• 配置全局身份：安装好后，得告诉Git你是谁。运行下面两条命令，记得把引号里的内容换成你自己的信息：
  • git config --global user.name “Your Name”
  • git config --global user.email “you@example.com”
  这个配置是全局的，设置一次，以后在这个系统上的所有Git操作都会用这个身份。
• 验证安装：怎么确认一切就绪呢？执行 git --version，如果终端乖乖地输出版本号，那就说明安装成功了。如果想再看看身份配置对不对，可以运行 git config --global --list 来检查一下。

完成这几步，你的Ubuntu系统就已经为PhpStorm的Git集成做好了准备。

二 在 PhpStorm 内配置 Git

环境好了，接下来就是让PhpStorm认识并调用我们刚装好的Git。

• 打开设置：进入 File → Settings（用快捷键 Ctrl+Alt+S 更快），然后在设置窗口里找到 Version Control → Git 这一项。
• 指定 Git 可执行文件路径：关键一步来了。在 Path to Git executable 这个输入框里，填入 /usr/bin/git。如果你是用系统包管理器（就是刚才的apt命令）安装的，默认路径就是这个。
• 测试 Git：填好路径后，别急着点确定。先点击右边的 Test 按钮。如果弹窗里显示出Git的版本号，恭喜你，集成成功了！
• 全局用户信息：为了省事，你也可以在IDE里统一设置提交者信息。还是在Git设置页面，找到 Committer 部分，填写Name和Email。这里的信息最好和你在终端里配置的全局信息保持一致，能避免提交记录里出现两个不同作者的混乱情况。

三 初始化仓库与基本操作

配置妥当，现在可以开始真正的版本控制之旅了。从初始化项目到日常提交，流程其实很直观。

• 将项目纳入版本控制：有两种方式。一是在PhpStorm顶部菜单选择 VCS → Enable Version Control Integration，然后在弹出的对话框里选择 Git。二是在项目根目录下打开终端，执行 git init 命令。效果是一样的。
• 添加与提交：这是最常用的操作。在项目文件上右键，选择 Git → Add，文件就被放到了暂存区。之后，通过点击工具栏的提交按钮或使用 Commit Directory，输入本次提交的说明信息，就能完成一次本地提交。
• 查看与对比：PhpStorm的 Version Control 工具窗口（通常在底部）是你的控制中心。在这里可以清晰地看到哪些文件是新增的（Unversioned）、修改过的（Modified）或已暂存的（Staged）。双击文件可以直接进行差异对比，查看历史记录也很方便。
• 推送与拉取：本地提交完成后，需要推送到远程仓库。可以通过工具栏的按钮，或者 VCS → Git 菜单里的 Push 来操作。首次推送时，通常会设置一个上游分支（比如将本地的master或main分支推送到origin远程仓库的同名分支），之后推送就更简单了。

四 连接远程仓库

独乐乐不如众乐乐，把代码放到GitHub、GitLab或Gitee这样的远程仓库，才能实现协作和备份。

• 新建远程仓库：先在GitHub等平台上创建一个新的空仓库，创建成功后，复制它的地址（HTTPS或SSH格式的URL）。
• 添加远程地址：怎么把本地仓库和这个远程地址关联起来呢？
  • 图形界面：在PhpStorm中，进入 VCS → Git → Remotes，点击“+”号，名称一般填 origin，URL就粘贴你刚复制的仓库地址。
  • 命令行：在项目根目录终端执行：git remote add origin 。
• 推送代码：关联之后，执行第一次推送命令：git push -u origin master（如果默认分支是main，则换成main）。这个 -u 参数是设置上游关联，以后在这个分支上直接执行 git push 就可以了。
• 认证方式：推送时可能会遇到认证问题，这取决于你用的地址类型：
  • HTTPS：首次推送会弹出窗口让你输入平台的账号密码，或者跳转浏览器登录授权。
  • SSH：这种方式更省心，但需要提前配置。将你本地SSH公钥（通常是 ~/.ssh/id_rsa.pub 文件内容）添加到托管平台的SSH Keys设置中，之后推送拉取就无需每次输入密码了。

五 常见问题与排查

路上难免遇到小石子，这里总结几个常见问题和解决办法，帮你快速排雷。

• Git 路径无效：如果在PhpStorm里测试Git失败，首先确认 /usr/bin/git 这个文件是否存在且有执行权限。如果你把Git装在了其他自定义路径，那么就在设置里指向那个实际路径，并再次点击 Test 验证。
• 提交者信息不一致：有时候提交历史里显示的作者名很奇怪。检查一下终端里 git config --global user.name/email 的输出，是否和PhpStorm中 Committer 的设置一致。统一它们就能解决。
• 无法连接远程仓库：推送或拉取报错？先核对三件事：远程URL地址对不对、本地和远程分支名是否匹配（比如master还是main）、认证方式选对了吗（HTTPS vs SSH）。可以尝试在终端用 git remote -v 和 git fetch 命令先验证一下连通性。
• 权限或认证失败：对于SSH方式，确保你的公钥确实已经正确添加到了代码托管平台。对于HTTPS，检查账号密码是否正确，或者考虑使用系统的Git凭据助手来保存密码，避免重复输入。
• 界面找不到 VCS 菜单：如果你在PhpStorm菜单栏里根本找不到VCS相关的选项，那很可能是因为当前项目还没有启用版本控制。先去执行 VCS → Enable Version Control Integration 并选择Git吧。