在 Debian 中配置 PhpStorm 使用 Git 版本控制
一 环境准备
- 安装 Git：在终端执行以下命令，完成后用 git --version 验证是否安装成功。
sudo apt update
sudo apt install git
git --version
- 配置 Git 全局身份（用于提交记录）：
git config --global user.name “Your Name”
git config --global user.email “your.email@example.com”
以上确保系统具备 Git 并具备提交者身份信息，是 PhpStorm 正常提交代码的前提。
二 在 PhpStorm 中启用与配置 Git
- 指定 Git 可执行文件路径：打开 File > Settings > Version Control > Git（macOS 为 Preferences），在 Path to Git executable 填入 /usr/bin/git，点击 Test 验证。
- 启用版本控制：打开项目后，进入 VCS > Enable Version Control Integration，选择 Git 并确认。
- 克隆现有仓库（可选）：File > New > Project from Version Control > Git，填入仓库 URL 与本地目录，点击 Clone。
- 首次提交与推送（若项目未初始化）：在项目根目录终端执行
git init
git add .
git commit -m “Initial commit”
然后在 PhpStorm 中 VCS > Git > Remotes 添加远程地址，使用 Git > Repository > Push 推送到远端。
以上完成 PhpStorm 与 Git 的集成、仓库初始化与首次推送。
三 日常协作常用操作
- 提交与推送：在 Version Control 面板勾选变更文件，填写提交信息后执行 Commit；随后 Git > Repository > Push 推送到远端分支。
- 拉取更新：VCS > Git > Pull 获取远端最新提交并合并。
- 分支管理：点击窗口右下角的 Git 分支 按钮，可执行 切换分支、检出远程分支、合并分支 等常用操作。
这些操作覆盖日常开发中最常用的提交、同步与分支协作流程。
四 常见问题与排查
- Git 未找到或路径错误：确认 /usr/bin/git 存在并可执行；在 Settings/Preferences > Version Control > Git 中重新指定路径并测试。
- 提交失败且无用户名或邮箱：在项目根目录或全局执行
git config --global user.name “Your Name”
git config --global user.email “your.email@example.com”
然后重新提交。
- 无法推送或拉取：检查远端 URL、分支名称与权限；必要时在 VCS > Git > Remotes 中核对或更新远程地址。
以上可快速定位并修复路径、身份与远端配置相关的常见问题。
