在 Debian 中配置 PhpStorm 使用 Git 的要点
- 在 Debian 上，PhpStorm 通过内置的 Git 集成完成版本控制。核心流程是：安装并配置 Git、在 PhpStorm 中指定 Git 路径、为项目启用版本控制、连接远程仓库并进行 Pull/Push 等协作操作。
一 环境准备
- 安装 Git
- 在终端执行：
sudo apt update && sudo apt install git
- 配置 Git 全局身份
- 设置用户名与邮箱（将示例替换为你的信息）：
git config --global user.name "Your Name"git config --global user.email "your.email@example.com"
- 验证安装
git --version 应输出版本号，例如：git version 2.xx.x。
二 在 PhpStorm 中配置 Git
- 指定 Git 可执行文件路径
- 打开设置：File → Settings → Version Control → Git（macOS 为 Preferences）
- 在 Path to Git executable 填入：/usr/bin/git
- 点击 Test 按钮，出现成功提示即可。
- 启用版本控制
- 打开项目后：VCS → Enable Version Control Integration，选择 Git 并确定。
- 首次提交与远程关联
- 将文件加入暂存：
git add .
- 提交：
git commit -m "Initial commit"
- 关联远程仓库（GitHub/GitLab 等）：VCS → Git → Remotes，添加远程地址（如
git@github.com:user/repo.git 或 https://github.com/user/repo.git）。
- 推送与拉取
- 推送：VCS → Git → Push（首次推送需选择分支并设置上游）
- 拉取：VCS → Git → Pull。
三 常用操作与团队协作
- 分支管理
- 在底部 Git 工具窗口可创建/切换/合并分支，或使用菜单 VCS → Git → Branches。
- 冲突解决
- 合并或拉取出现冲突时，PhpStorm 会标记冲突文件；打开文件，使用内置的 Merge/Resolve 工具选择保留内容，保存后标记为已解决，再提交。
- 查看历史与差异
- 使用 Log 与 Diff 视图查看提交历史、对比版本差异，支持按文件/提交范围查看。
四 常见问题排查
- Git 路径无效或未检测到
- 确认路径为 /usr/bin/git，在设置中点击 Test；若失败，检查是否安装了 Git 或尝试重装：
sudo apt install --reinstall git。
- 提交时报错 “no user.name configured”
- 在系统终端执行：
git config --global user.name "Your Name" 与 git config --global user.email "your.email@example.com"，然后重启 PhpStorm。
- 无法推送到远程仓库
- 检查远程地址是否正确、是否有权限；如使用 SSH，确保 SSH 密钥已添加到 GitHub/GitLab；如使用 HTTPS，确认凭据或令牌有效。
