根本原因是webstorm终端未加载shell配置文件，导致path等环境变量缺失；需在settings→tools→terminal中正确设置shell path并重启终端窗口验证。
为什么WebStorm内置Terminal不识别hg或git命令
根本原因是GUI应用（如WebStorm）启动时不加载shell配置文件（~/.zshrc、~/.bash_profile等），所以nvm、PATH扩展、别名全失效。即使你在终端里能跑hg version或git --version，WebStorm的Terminal默认也找不到这些命令。
验证方式：在WebStorm Terminal里直接执行which hg或which git，如果返回空，就确认是PATH缺失问题。
- macOS用户需在
Settings → Tools → Terminal → Shell path中填/bin/zsh或/bin/bash（取决于你日常用的shell） - Windows用户若用Git Bash，Shell path填
C:\Program Files\Git\bin\bash.exe；若用WSL，填wsl.exe - Linux用户同理，确保Shell path指向你实际使用的shell二进制，比如
/usr/bin/zsh - 改完后必须重启Terminal工具窗口（关闭再打开），否则环境变量不会刷新
hg commit失败提示“abort: no files changed”但文件明明有修改
Mercurial默认只提交已跟踪（tracked）且状态为modified的文件。如果你刚添加新文件，它处于untracked状态，hg commit会跳过——这不是bug，是hg的设计逻辑。
常见误操作是直接敲hg commit -m "msg"，结果什么都没提交成功。
- 先运行
hg status确认文件状态：M表示已跟踪并修改，?表示未跟踪 - 对新文件，必须先
hg add <filename></filename>或hg add .（慎用，可能误加不需要的文件） - 如果只想提交部分修改，用
hg commit -I <file1> -I <file2></file2></file1>指定文件，避免hg commit -A（它会强制add所有untracked文件） - WebStorm图形界面里右键文件→
Mercurial → Add，比命令行更安全，尤其对二进制或配置文件
git push报错“failed to push some refs to 'xxx'”，提示remote分支不存在
这是典型分支未关联场景，不是网络或权限问题。WebStorm的Push对话框里显示Define remote按钮，说明本地分支还没绑定远程对应分支。
直接在Terminal里执行
git push -u origin <branch-name></branch-name>最可靠，
-u参数会同时设置upstream跟踪。
- 不要依赖WebStorm自动推断远程名——它有时会填错成
origin2或空值 - 确认远程地址是否正确：
git remote get-url origin，若为空或错误，先git remote add origin <url></url> - 如果远程仓库是新建的，首次推送必须带
-u；后续推送可直接git push - WebStorm里右键分支→
Git → Set upstream branch也能手动关联，但Terminal命令更透明、不易出错
Terminal里执行hg pull后没反应，或提示“no changes found”但远程明明有更新
hg pull只下载变更集（changesets）到本地仓库，并不自动更新工作目录文件。这是Mercurial和Git的关键区别之一——Git的git pull = fetch + merge，而hg的pull只是fetch。
用户常误以为“pull完就同步了”，结果代码还是旧的。
- 执行
hg pull后，必须紧接着hg update（或简写hg up）才能把工作目录切换到最新版本 - 想一步到位，用
hg pull -u，-u参数即自动update - 如果
hg pull提示“no changes found”，先确认远程仓库是否有新changeset：hg incoming（查看待拉取的变更） - WebStorm图形界面里点击
VCS → Mercurial → Pull默认带-u，所以不会出现这问题——但Terminal里必须自己加
hg status或git status看一眼，比盲目push或commit安全得多。
