PhpStorm 初始化 Git 须先执行 git init 创建 .git 目录，否则 VCS 无法识别；修改文件需手动 Add 或检查 .gitignore；Push 失败主因是密码认证弃用，应配 SSH 或令牌；切换分支前须处理未提交更改，推荐 stash 而非强制覆盖。
怎么在 PhpStorm 里正确初始化 Git 仓库
不是点一下“enable version control integration”就完事了——很多人漏掉关键一步：必须先有本地 .git 目录，phpstorm 才能真正接管。如果项目还没初始化，它只会显示灰色的 git 图标，所有提交按钮都是禁用状态。
实操建议：
- 终端进项目根目录，运行
git init（别跳过这步，PhpStorm 不会自动帮你 init） - 再打开 PhpStorm，或右键项目根目录 →
VCS → Import into Version Control → Create Git Repository（本质还是调git init，但路径容易选错） - 确认
.git文件夹真实存在且非空；否则后续所有commit/push操作都会静默失败
为什么 PhpStorm 的 Commit 窗口不显示修改文件
常见现象是：改了代码，左边 Project 面板有蓝色标记，但打开 Commit 窗口一片空白——大概率是文件没被 Git 跟踪，或者被 .gitignore 拦截了。
实操建议：
- 检查右下角状态栏是否显示
Git: [branch]；不显示说明 VCS 根本没识别到仓库 - 右键修改过的文件 →
Git → Add（对应git add），加完才会出现在 Commit 窗口 - 如果文件名是灰色的，鼠标悬停看提示：可能是匹配了
.gitignore规则，比如vendor/、var/cache/或 IDE 自动生成的.idea/ - 临时调试可执行
git status -uall对照看，比 PhpStorm UI 更直白
Push 失败报 “Authentication failed” 怎么快速修复
错误信息通常是 remote: Support for password authentication was removed 或直接卡在用户名密码弹窗——GitHub、GitLab 等平台已全面停用密码登录，必须用 token 或 SSH。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 优先配 SSH：生成密钥后，把公钥贴到 Git 平台的 SSH Keys 设置页，然后把远程地址从
https://...改成git@xxx.com:user/repo.git - 若坚持用 HTTPS，在 PhpStorm 中：进入
Settings → Version Control → Git → Authentication → Password，删掉旧凭据，再点 Push —— 此时会弹出浏览器登录，自动返回 token 并缓存 - 别在 PhpStorm 里手动输密码，它不会保存，下次还报错
- Windows 用户注意：系统凭据管理器里残留的旧密码会干扰，需手动清理
git:https://xxx.com条目
切换分支时提示 “Uncommitted changes would be overwritten”
这不是 PhpStorm 的 bug，而是 Git 的保护机制：你有未提交的修改，而目标分支里同名文件在相同位置有不同内容，强行切换会导致丢失。
实操建议：
- 别急着点 “Shelve Changes”——它只是临时隐藏，下次切回来还得手动恢复；先想清楚：这些改动能否提交？要不要保留？
- 如果确定要丢弃，终端执行
git checkout -f branch-name（PhpStorm 不提供强制覆盖入口） - 如果想保留但又不想立刻提交，用
git stash更可控：终端运行git stash push -m "wip-login-fix"，切完再git stash pop - PhpStorm 的 Branches 面板里，“Stash Changes” 按钮只 stash 当前工作区，不包含未跟踪文件（untracked files），这点和命令行默认行为不同
git status 或 git log --oneline --graph，看看真实状态。IDE 是工具，不是黑箱。 
