git分支名本身不会自动关联看板系统，必须同时满足分支命名规范（如feature/req-123-login）、commit message包含相同id、工具端开启自动关联并配置正确正则，且codespace需主动链接上游分支，四者缺一不可。
Git 分支名本身不会自动关联任何看板系统——必须依赖约定 + 工具配置才能触发关联。YesDev、Jira、Tapd 等工具都只认特定格式的分支名（比如 feature/REQ-123-login），且需在项目设置中开启「分支自动关联」开关，否则提交再规范也无效。
分支命名必须匹配看板 ID 格式
YesDev 和多数敏捷工具只通过正则匹配分支名中的需求/任务编号，例如 REQ-123、BUG-456、TASK-789。不满足格式就无法提取 ID，自然无法上屏或挂载到对应卡片。
- ✅ 推荐写法：
feature/REQ-123-user-login、hotfix/BUG-456-null-pointer - ❌ 无效写法：
feat-login、fix-bug、dev/req123（缺分隔符或前缀） - 工具默认识别的前缀通常固定为
feature/、bug/、task/，不能随意改成work/或dev/ - 部分平台支持自定义正则，但需管理员在「集成设置 → Git 分支规则」里配置，普通成员无权修改
提交信息也要带相同 ID 才能补全关联链
仅分支名匹配还不够。YesDev 要求 git commit -m 的首行必须包含相同编号，比如 REQ-123: implement login flow。否则分支虽被识别，但具体 commit 记录不会出现在需求弹窗的「代码提交记录」区。
- 分支名和 commit message 中的 ID 必须完全一致（大小写、连字符、数字均需相同）
- commit message 中 ID 不必在开头，但建议放最前面，避免被工具截断
- 如果用了
git rebase -i修改历史，旧 commit 的 ID 若被删或改错，已关联的记录会断开，不会自动修复
Codespace 创建时分支未自动链接，关联会失效
GitHub Codespaces 默认不会把新 codespace 绑定到上游分支——除非你主动推送或手动选择分支。若直接在未链接的 codespace 里提交，生成的 commit 属于孤立分支，看板工具根本收不到事件通知。
- 创建 codespace 后首次
git push时，终端会提示「Link to new or existing branch? (y/n)」，必须输y - 若用 VS Code 源码管理面板提交，它会自动 fork 并推送到个人分支，但该分支未必符合看板要求的命名规则
- 检查当前 codespace 是否已链接：看 VS Code 状态栏显示的分支名是否属于原仓库（而非你的 fork），且名称含有效 ID
真正容易被忽略的是：分支名匹配只是起点，commit message、codespace 关联状态、工具端的正则配置这三者缺一不可。少一个环节，关联就断在中间，看板里只显示「无代码提交」。
