VSCode 通过 Git 命令和扩展支持 Tag 管理:需先 Fetch all tags 才能在状态栏查看并检出;创建用 Git: Create Tag;推送/删除须在终端执行;推荐 GitLens 或 Git Graph 扩展提升体验。

VSCode 本身不提供图形化标签(Tag)管理界面,但通过集成 Git 命令和扩展支持,可以高效完成打标、查看、检出、删除等常见 Tag 操作。关键在于熟悉终端命令 + 合理使用内置功能与轻量扩展。
查看和检出已有 Tag
在 VSCode 中打开项目后,点击左下角状态栏的 Git 分支名(如 main),会弹出分支/标签列表。这里默认只显示分支;要看到 Tag,需先确保已从远程拉取全部标签:
- 按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(Mac),输入 Git: Fetch,选择 Fetch all tags
- 再次点击状态栏分支名,就能在下拉列表中看到带 tag: 前缀的条目(如 tag: v1.2.0)
- 点击任一 tag 即可检出为“分离头指针”(detached HEAD)状态——适合验证发布版本,不建议直接在此修改
创建本地 Tag
VSCode 没有“右键打标”菜单,但可通过命令面板快速执行 Git 命令:
- 按 Ctrl+Shift+P → 输入 Git: Create Tag → 回车
- 输入 tag 名(如 v2.0.0),回车确认
- 若需附带注释,可在命令后加 -a -m "Release version 2.0.0"(需在终端中手动运行
git tag -a v2.0.0 -m "...") - 新 tag 仅存在于本地,不会自动推送到远程
推送和删除 Tag
推送/删除 Tag 必须使用终端(集成终端快捷键:Ctrl+`):
- 推送单个 tag:
git push origin v1.2.0 - 推送所有本地 tag:
git push origin --tags - 删除本地 tag:
git tag -d v1.2.0 - 删除远程 tag:
git push origin --delete v1.2.0或git push origin :refs/tags/v1.2.0
注意:删除远程 tag 后,其他人需手动运行 git fetch --prune --tags 才能同步更新本地 tag 列表。
增强体验的小建议
想更直观地管理 Tag,可安装轻量扩展:
- GitLens:在侧边栏提供 Tags 视图,支持排序、搜索、一键检出/推送,还显示 tag 关联的提交和作者
- Git Graph:以可视化图谱展示分支与 tag 的关系,点击 tag 可快速检出或复制 commit ID
- 避免用 VSCode 内置“源代码管理”视图右上角的 ... 菜单操作 tag——它不包含 tag 相关选项
基本上就这些。不复杂但容易忽略的是:tag 默认不随 fetch 自动同步,手动 fetch tags 是日常操作的第一步。










