Git Flow插件需先初始化才能使用Start Feature功能：点击右下角“No Gitflow”→“Init Repo”→勾选“Use non-default configuration”，设Master为main、Develop为develop，否则默认用master；未初始化则右键无选项，feature分支命名不规范或Finish Release后未push tag也会引发问题。
Git Flow 插件装完却点不了「Start Feature」？
不是插件没生效，而是项目还没初始化 Git Flow 工作流。IDEA 里装完 Git Flow Integration 后，右下角显示 No Gitflow 是正常状态，必须先初始化才能用所有功能。
- 打开项目后，点击右下角
No Gitflow→ 选Init Repo - 勾选
Use non-default configuration，否则默认会把master当主干分支（新项目常用main） - 手动填：
Master branch设为main，Develop branch设为develop，其余保持默认即可 - 点 OK 后，右下角变成 Git Flow 图标，此时
Start Feature才可点击
常见坑：没初始化就直接右键菜单找 Git Flow 选项，结果列表为空——因为插件根本没绑定到当前仓库上下文。
feature 分支命名不规范导致 push 失败
Git Flow Integration 默认按 feature/xxx 格式创建分支，但如果你在弹窗里输的是 user-login（没带前缀），插件会自动补成 feature/user-login；但如果远程已有同名分支且保护规则开启，push 时可能被拒绝。
- 检查远程是否已存在该分支：
git ls-remote --heads origin feature/user-login - 确认远程分支保护策略：比如要求 PR、CI 通过、禁止直接 push 到
feature/* - 如果团队约定前缀是
feat/而非feature/，插件本身不支持改前缀，只能手动切分支后重命名：git branch -m feature/user-login feat/user-login
注意：Finish Feature 会自动删除本地和远程的 feature/xxx 分支，但不会删你手动建的 feat/xxx —— 容易残留垃圾分支。
工程问题的自动化迭代实验室。给定一个 idea 或工程问题，自动调研方案、设计实现、验证效果、迭代优化，结果存入 Notion。触发词："idea-lab"、"实验一下"、"帮我验证"、"迭代优化"、"idea 验证"。当用户提出一个工程问题并希望自动化地调研→设计→验证→迭代时使用此 skill。
Finish Release 后 master 没更新 tag？
点 Finish Release 后，插件确实会合并到 main 和 develop、删 release 分支、打 tag，但 tag 默认只存在于本地，不会自动 push 到远程。
- 执行完
Finish Release后，立刻执行：git push origin --tags - 如果想让插件自动 push tag，得在 IDEA 设置里开开关：Settings → Version Control → Git → 勾选
Push tags automatically - 若团队用 CI/CD 基于 tag 触发构建，漏 push tag 就会导致部署卡住
另一个坑：Finish Release 前没拉最新 develop，合并后 main 可能缺提交——插件不做校验，全靠人盯。
hotfix 分支修复后，develop 合并出错
Finish Hotfix 本该同时合并到 main 和 develop，但实际只合了 main，或者 develop 合并后出现大量冲突，说明 hotfix 提交历史和 develop 已有分叉。
- hotfix 必须从
main创建，不能从develop或其他分支拉 - 修复完 commit 后，先
git checkout develop && git merge --no-ff hotfix/xxx手动测一遍冲突，再用插件 finish - 插件 merge 时默认用
--no-ff，但若develop有快进可能，它会跳过 merge commit，导致 hotfix 提交丢失上下文
最易忽略的一点：hotfix 的 commit message 里别带 chore: 或 docs:，某些 CI 规则会过滤这类提交，导致修复没进构建流水线。
