VSCode 不自动同步 git tag 到远程，需手动执行 git push origin <tagname> 或 git push origin --tags；检出标签会进入 detached HEAD 状态，应基于其创建新分支修改。
git tag 命令不生效，打完标签本地没反应？
VSCode 本身不自动同步 git tag 操作到远程，打完标签后 git tag 能查到，但 git ls-remote --tags origin 看不到——这是最常被忽略的第一步。VSCode 的“源代码管理”面板也不会主动刷新标签列表，它只显示已 fetch 过的标签。
实操建议：
- 打完本地标签必须手动推送：
git push origin <tagname>或批量推所有未推标签：git push origin --tags - VSCode 中点击右下角分支名 → “Fetch from origin” 才能拉取新标签；仅“Pull”不会获取新 tag
- 如果用 VSCode 内置终端打标签，注意当前工作目录是否在 Git 仓库根路径（
git rev-parse --git-dir可确认）
VSCode 里怎么快速查看和检出某个 tag？
VSCode 没有独立“标签面板”，但可通过命令面板 + Git 视图组合完成。关键在于理解：tag 是只读快照，检出后会进入“分离头指针（detached HEAD）”状态——这不是错误，是预期行为。
实操建议：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入并选择：Git: Checkout to... - 在弹出列表中选中目标
v1.2.0类似标签名，回车即可检出 - 检出后状态栏显示
HEAD（不是分支名），此时禁止直接提交；如需基于该版本改东西，应先创建新分支：git checkout -b hotfix-from-v1.2.0
用 VSCode 创建带注释的 tag 总是变成轻量标签？
git tag v1.2.0 是轻量标签（lightweight），只存 commit hash；而 git tag -a v1.2.0 -m "release" 才是附注标签（annotated），含作者、时间、签名等元数据——CI/CD 工具和语义化版本工具（如 standard-version）通常只认后者。
实操建议：
- VSCode 终端里别省略
-a和-m参数，否则默认生成轻量标签 - 想设默认编辑器写注释？运行：
git config --global core.editor "code --wait"，再用git tag -a v1.2.0（不带-m）就会唤起 VSCode 编辑窗口 - 检查是否为附注标签：
git show v1.2.0—— 有 tagger、date、message 即为正确
为什么 VSCode 的 Git 图形界面看不到刚打的 tag？
VSCode 的“源代码管理”视图 → “分支”下拉菜单只列分支，不列 tag；“Commits”面板默认也不显示 tag 名称，除非该 commit 被打过 tag 且已 fetch 到本地。
实操建议：
- 打开命令面板 → 输入
Git: View History (git log)，在日志图中右键某次 commit → “Tag this commit...” 可图形化打 tag（但依然要手动 push） - 想让 tag 显示在 commit 旁：确保已执行
git fetch --tags，且 VSCode 设置中开启"git.showTags": true（默认开启） - 插件不是必需项，但
GitLens可在行号边直接显示 tag 标记，比原生视图更直观
标签不是分支，没有持续演进能力；发布后若发现严重问题，得基于 tag 新建分支修复，再打新 tag。很多人卡在“以为检出 tag 就能直接改代码”，其实那只是个快照快照快照。
