phpstorm如何配置Git版本控制（代码同步指南）-phpstorm-PHP中文网

phpstorm未识别git项目需确认.git目录位置，应打开含.git的根目录或手动配置version control映射；文件不显示在commit窗口多因被忽略或排除，可通过右键add、检查ignored files及git check-ignore排查；push失败报“non-fast-forward”时应先pull并勾选rebase而非强制推送。

phpstorm如何配置git版本控制（代码同步指南）

PHPStorm 里 Git 根本没识别到项目？先确认 `.git` 目录和路径

PHPStorm 不自动启用 Git，不是它“坏了”，而是它只认当前项目根目录下存在有效的 .git 目录。常见误操作是：把项目 clone 到 /Users/xxx/project，却用 PHPStorm 打开的是它的子目录 /Users/xxx/project/src —— 这时 PHPStorm 看不到 .git，Git 菜单灰掉，VCS 设置里也找不到 Git。

解决方法很简单：

关掉当前项目，重新用 PHPStorm 打开 包含 .git 的那个最外层文件夹
如果已打开但 Git 未激活，进 File → Settings → Version Control（macOS 是 PhpStorm → Preferences → Version Control），点击 + 号，手动添加目录映射，路径填项目根路径，VCS 选 Git
检查 .git 是否损坏：终端进项目根目录，运行 git status，若报错 fatal: not a git repository，说明真没初始化，得先 git init 或重新 git clone

提交时提示 “No files selected” 或文件不显示在 Commit 窗口？检查文件状态和忽略规则

PHPStorm 的 Commit 窗口默认只列出 Unversioned、Modified、Added 等待提交的文件。如果改了代码却看不到，大概率是文件被标记为 Ignored 或处于 Excluded 状态。

排查步骤：

右键文件 → Git → Add（或按 Ctrl+Alt+A / Cmd+Alt+A），强制加入暂存区；如果菜单灰色，说明该文件已被 .gitignore 匹配，或目录被 PHPStorm 自己设为 Excluded（右键目录 → Mark Directory as → Excluded）
打开 VCS → Git → Repository → Ignored Files，看有没有误加的规则，比如整条 vendor/ 或 *.log 把你刚写的 debug.log 给拦了
终端执行 git check-ignore -v your-file.php，能立刻定位是哪条 .gitignore 规则生效

Push 失败报错 “rejected — non-fast-forward”？别硬用 `--force`，先做 `pull --rebase`

这个错误本质是远程分支有你本地没有的提交（比如同事刚 push 了），而你的本地分支落后了。PHPStorm 默认 pull 是 merge 方式，容易产生多余 merge commit；更干净的做法是 rebase。

One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载

推荐操作流：

点顶部菜单 VCS → Git → Pull，弹窗里勾选 Rebase current branch on upstream（不是默认选项！）
如果已出现冲突，PHPStorm 会高亮冲突文件，双击打开，用内嵌的三栏对比工具解决（保留绿色/蓝色部分，删掉
解决后，右下角有 Commit and Push 按钮，点它会自动 commit rebase 后的改动并 push；别跳过 commit 直接 push，否则 rebase 中断状态会导致后续异常
绝对避免在团队协作中直接点 Force Push——除非你明确知道后果且已跟所有人同步

PHPStorm 提交记录里中文乱码？统一设置 Git 的 commit encoding 为 UTF-8

Windows 用户尤其容易遇到：命令行 git log 看中文正常，但 PHPStorm 的 Log 工具窗口里 commit message 全是问号或方块。这不是 PHPStorm 显示问题，而是 Git 自身读取 commit 时用了错误编码。

修复只需一条命令（在项目根目录终端运行）：

git config --add i18n.commitencoding utf-8

补充说明：

这条配置写入项目级 .git/config，不影响其他仓库；如需全局生效，加 --global 参数
PHPStorm 本身编码设置（Settings → Editor → File Encodings）设为 UTF-8 是必要但不充分条件，Git 层必须单独声明
如果之前已有乱码 commit，它们无法自动修复，但新 commit 会正常显示

Git 在 PHPStorm 里真正卡住人的地方，往往不是功能不会用，而是它严格遵循 Git 原生命令的行为逻辑——比如不自动识别子目录下的仓库、不绕过 .gitignore、不替你处理非快进冲突。看清它“只是个可视化外壳”，很多问题就从“为什么不行”变成“我该让 Git 怎么做”。