WebStorm 提交失败主因是默认启用“只提交已暂存文件”模式，需手动勾选文件暂存（等效 git add）后再提交；未暂存文件即使写入 message 也不会真正提交。
WebStorm 的 Git 提交不是“点一下就完事”，关键在于它默认把 git add 和 git commit 拆成两步，而且提交前不自动暂存——很多人卡在这一步，以为点了 Commit 就提交了，结果 push 时发现啥都没上去。
为什么点了 Commit 按钮却没提交成功
WebStorm 默认启用 “Commit only staged files”（只提交已暂存文件）模式。你改了 app.js，但没手动 git add 或在界面里勾选它，那它就不会出现在提交列表里——哪怕你写了 commit message、点了 Commit，实际什么都没提交。
- 检查右下角状态栏：如果显示
1 uncommitted change，说明文件还没暂存 - 打开
Git tool window（Alt+9），看 “Local Changes” 标签页：未暂存文件在 “Unversioned Files” 或 “Uncommitted Changes” 下，灰色文字；已暂存的会移到 “Staged Changes” 且变黑加粗 - 想跳过暂存直接提交？进
Settings > Version Control > Git，取消勾选Commit only staged files（但不推荐，容易漏提交或误提交）
怎么正确完成一次 Git Commit（含暂存 + 提交）
最稳的操作路径是：先暂存要提交的变更，再写 message 提交。WebStorm 把这个过程可视化了，但得主动点几下。
- 改完代码后，按
Ctrl+K（Windows/Linux）或Cmd+K（macOS），直接唤出 Commit 窗口 - 在左侧文件列表里，勾选你要提交的文件（支持单选、多选、按住 Ctrl/Cmd 点选）；勾选即等效执行
git add - 在下方输入框写 commit message；支持
Ctrl+Enter快速提交（前提是没勾选 “Commit and push”） - 如果想提交并立刻 push，勾选右下角
Commit and push，它会在 commit 后弹出 push 确认框
Commit message 写错 / 想修改刚提交的内容怎么办
WebStorm 不提供“编辑已提交 message”的按钮，但底层用的是标准 git，所以可以靠命令行补救——别在 GUI 里找“修改上次提交”选项，它根本没暴露这个功能。
- 如果刚 commit 完还没 push：在 Terminal 里运行
git commit --amend -m "new message" - 如果已经 push 过：不能直接 amend，得
git push --force-with-lease origin branch-name（注意团队协作中 force push 需谨慎） - WebStorm 的
VCS > Git > Show History只能看 log，不能改；右键某次提交也看不到 “amend” 菜单项
常见坑：中文路径/文件名提交失败、commit 无响应
这类问题通常和 WebStorm 的 git 配置或系统环境有关，不是操作流程问题。
- 中文路径报错
fatal: Pathspec 'xxx' is in submodule或乱码：检查 WebStorm 是否用了内置 git；进Settings > Version Control > Git，把Path to Git executable改成系统安装的完整路径（如/usr/bin/git或C:\Program Files\Git\bin\git.exe） - 点了 Commit 没反应、窗口卡住：关闭
.idea/vcs.xml中可能残留的异常配置，或删掉项目根目录下的.git/index.lock文件（确保没其他 git 进程在跑） - 提交后
git status显示 still dirty：可能是 WebStorm 缓存了文件状态，点VCS > Git > Refresh File Status或重启 IDE
真正容易被忽略的，是 WebStorm 对 “staged” 和 “unstaged” 的严格区分——它不像 VS Code 那样默认帮你 add -A，也不像命令行那样一眼看到 git status 输出。你得养成看 “Local Changes” 窗口颜色和位置的习惯，否则每次提交都像在猜。
