在 Debian 上完成 PhpStorm 与 Git 的集成

一 环境准备

首先，得确保你的 Debian 系统已经装好了 Git。这事儿不复杂，打开终端，按顺序执行下面几条命令就行。完成后，别忘了用 git --version 验证一下，看到版本号就说明安装妥了。

sudo apt update
sudo apt install git -y
git --version

接下来，配置你的全局身份信息。这步很重要，因为之后所有的提交记录都会带着这个信息。

git config --global user.name “Your Name”
git config --global user.email “your.email@example.com”

当然，如果你对版本有特殊要求，比如需要某个新特性，或者系统仓库里的版本太旧，也可以选择从源码编译安装。操作稍微多几步，但能确保你拿到想要的版本。

sudo apt update
sudo apt install -y make libssl-dev libghc-zlib-dev libcurl4-gnutls-dev libexpat1-dev gettext unzip
# 下载并解压 Git 源码后
make prefix=/usr/local all
sudo make prefix=/usr/local install

走完以上这几步，一个可用的 Git 环境就算搭建完成了。

二 在 PhpStorm 中配置 Git

环境准备好了，现在打开你的 PhpStorm，让它和 Git 认识一下。

• 打开设置：通过菜单栏的 File → Settings → Version Control → Git（macOS 用户是 Preferences）进入配置页面。
• 配置 Git 路径：在 “Path to Git executable” 这一栏里，填入 /usr/bin/git，然后点击右边的 “Test” 按钮。如果配置正确，你会看到 “Git executed successfully” 的提示。
• 确认用户信息：你可以在同一个页面，或者去 Settings → Version Control → GitHub 里，确认或补充你的账号信息。这主要是为了后续和 GitHub、GitLab 这些远程仓库服务交互时更方便。
• 启用版本控制：如果你的项目还没纳入 Git 管理，可以通过菜单 VCS → Enable Version Control Integration → 选择 Git 来初始化。

完成这些配置后，PhpStorm 就能顺畅地调用系统 Git 来执行各种版本控制操作了。

三 常用操作与远程仓库

配置好了，接下来看看日常开发中怎么用。其实核心就是几个高频操作。

• 初始化与提交
  • 初始化仓库：如果项目还没初始化，可以在项目根目录的终端里执行 git init。当然，如果你已经通过上一步在 PhpStorm 里启用了版本控制，这步可以跳过。
  • 添加与提交：改动完成后，可以直接在 PhpStorm 的界面里提交，或者在终端里执行经典的两连击：

  git add .
  git commit -m “Initial commit”

• 关联与推送至远程
  • 添加远程仓库：通过菜单 VCS → Git → Remotes，添加一个名为 origin 的远程地址，填入你的仓库 URL（HTTPS 或 SSH 格式都行）。
  • 推送代码：使用 VCS → Git → Push。如果是第一次推送，通常需要设置上游分支，比如执行 git push -u origin main。
• 拉取更新
  • 很简单，在 PhpStorm 里点 VCS → Git → Pull，或者在终端执行 git pull 就行。
• 分支与冲突
  • 创建、切换分支，可以通过 PhpStorm 右下角的 Git 工具窗口轻松完成。合并代码和解决冲突，也都有直观的图形界面支持，这对新手来说非常友好。

上面这套流程，基本覆盖了日常开发中的提交、推送、拉取和分支协作这些核心场景。

四 常见问题排查

最后，分享几个可能会碰到的小问题及其解决办法，以备不时之需。

• 报错 “Cannot run program git” 或找不到 Git：这个问题通常是指令路径不对。请回到 PhpStorm 的设置里，在 Git 配置页显式指定 /usr/bin/git 并点击 Test 验证。或者，你也可以在系统终端里输入 which git 命令，看看它返回的路径是不是 /usr/bin/git。
• 提交作者信息不正确：如果发现提交记录里的名字或邮箱不对，可以在项目根目录（仅对该项目生效）或全局执行以下命令来修正：

git config user.name “Your Name”
git config user.email “your.email@example.com”

• 需要最新版 Git：如果系统仓库的版本满足不了你的需求，可以回过头，按照第一部分“环境准备”里“从源码安装”的步骤，自己编译安装最新版本，以获得新特性和修复。