WebStorm切换Git分支必须通过Git Branches面板操作，右下角点击仅打开面板而非执行切换；远程分支需先Fetch更新remote-tracking分支再Checkout；新分支推送需手动设置upstream；Commit模板不生效多因.gitmessage编码错误或vcs.xml缓存未刷新。
WebStorm 里操作 Git 管理 Vue 项目，核心不是“会不会点”，而是“点对位置、时机和上下文”——右下角点分支名 ≠ 切分支，Remote 分支 Checkout 前不 Fetch 就会失败，Commit 模板不生效多半是 .gitmessage 编码或缓存问题。
点右下角分支名为什么没切换成功
WebStorm 右下角显示的 main 或 dev 只是当前分支快照，点击它只是打开 Git Branches 面板，不是执行切换动作。很多用户点了没反应，或者文件没变，本质是误以为“点一下就完事”。
- 真正切换必须进 Git Branches 面板 → Local 标签 → 双击目标分支名，或右键 →
Checkout - 如果面板里 Local 标签下为空，先检查项目根目录是否存在
.git；存在但无内容，执行Git → Repository → Refresh - 切换前工作区必须干净：有未提交修改时，WebStorm 会阻止切换，或弹出
Shelve提示（可勾选自动暂存）
Checkout 远程分支（如 origin/feat/user-profile）报 “no changes”
你在 Remote Branches 下看到该分支，右键 Checkout 却失败，大概率是因为本地还没同步它的 commit 引用。Git 不会自动拉取远程分支元数据。
- 第一步永远是
Fetch：点右下角分支指示器 →Fetch，或菜单Git → Repository → Fetch - Fetch 完后，
Remote Branches里才真正出现该分支的最新引用；此时再右键 →Checkout，WebStorm 才会创建同名本地分支并检出对应 commit - 怀疑远程分支不存在？终端执行
git ls-remote --heads origin feat/user-profile确认 - 别误点
Checkout Revision——那是按 commit hash 检出，不是分支
新分支 push 报 “No tracking information”
新建分支 bugfix/modal-close 并提交后，右键 → Push 报错：The current branch bugfix/modal-close has no upstream branch。这不是权限问题，是 Git 缺少上游映射。
git摸鱼周报自动化
下载
生成周报：读取本机 Git 仓库最近一周的提交记录，按项目分类提炼总结，生成标准周报格式，通过微信推送并返回给用户。触发词：周报、weekly report、git总结、提交记录总结、工作周报。
立即学习“前端免费学习笔记（深入）”；
- 首次推送新分支时，WebStorm 默认不设
upstream，必须手动指定 - 正确做法：右键分支 →
Push→ 弹窗中勾选Set upstream，或点Configure旁小齿轮 → 选Push current branch as new branch to origin - 后续再
push就无需重复设置；也可命令行补救：git push -u origin bugfix/modal-close - 分支名含
/（如feat/user-profile）会自动在 Git Branches 面板中分组，便于识别，但不影响推送逻辑
Commit message 不自动加载模板
WebStorm 的 Commit 对话框不读 IDE 设置，只读 Git 自身配置。模板不生效，90% 是 .gitmessage 文件或 Git 配置没到位。
- 在项目根目录新建
.gitmessage文件（UTF-8 无 BOM 编码，Windows 记事本易加 BOM，建议用 VS Code 或 WebStorm 自建） - 执行
git config commit.template .gitmessage绑定；想全局生效用git config --global commit.template ~/.gitmessage - 验证是否生效：终端进项目根目录，运行
git config commit.template，应输出.gitmessage或绝对路径 - 若输出正确但 WebStorm 仍不显示，关掉 IDE，删掉
.idea/vcs.xml（它缓存 Git 配置），再重启 - 注意：WebStorm 不执行 husky + commitlint 校验，校验发生在点
Commit后、写入仓库前，失败时弹出Command failed，需点Show Output查具体规则
最常被忽略的其实是「Fetch」和「vcs.xml 缓存」——前者让远程分支不可见，后者让 Git 配置在 WebStorm 里形同虚设。这两个点卡住的人最多，但解决起来就两行命令或一次删除。
