VSCode 无法仅靠内置功能实现 SemVer 自动化，因其 Git 命令不解析 package.json、不判断版本级别、不强制 v 前缀与附注标签；必须借助 standard-version 或 npm version 等工具链集成。
VSCode 本身不内置 SemVer 版本号自动递增或标签生成逻辑，所有这类操作都依赖外部工具链（如 standard-version、npm version）与 Git 集成。直接在 VSCode 界面点几下无法实现“自动递增+打标签+推送”，必须配置命令行行为或工作流。
为什么不能只靠 VSCode 命令面板完成 SemVer 自动化
VSCode 的 Git: Create Tag 和 Git: Push Tag 是纯手动操作：它不读取 package.json 中的当前版本，也不判断该升 patch 还是 minor，更不会自动生成符合 SemVer 规范的标签名（比如 v1.4.2 而不是 1.4.2）。你输什么它就建什么，输错格式（如漏掉 v 前缀）会导致下游工具（如 GitHub Actions、vsce）无法识别。
常见错误现象：
- 在命令面板里输
1.5.0创建标签 → 远程仓库收到1.5.0，但standard-version或 CI 脚本默认只认v1.5.0 - 用
Git: Push Tag推送后，GitHub Actions 没触发 → 因为工作流监听的是push.tags事件，而你推的是轻量标签（VSCode 默认创建），但 CI 配置要求附注标签 -
package.json版本仍是1.4.2，但已打了v1.5.0标签 → 版本号与代码实际状态脱节，vsce publish会发布错误版本
用 standard-version 实现语义化版本 + 标签 + changelog 一体化
这是目前最贴近“VSCode 内一键完成”的方案：把 standard-version 封装成 VSCode 可调用的脚本任务，再绑定到快捷键或命令面板。
实操建议：
- 安装：
npm install --save-dev standard-version - 在
package.json的scripts中添加："release": "standard-version"（默认按 conventional commits 判断升哪一级） - 在 VSCode 中按
Ctrl+Shift+P→ 输入Tasks: Run Task→ 选release，即可自动完成：
– 升级package.json中的version
– 生成CHANGELOG.md
– 创建附注标签（带-a -m，前缀v）
– 提交变更（含package.json和CHANGELOG.md） - 注意：它默认不推送标签，需额外加
--commit-all --tag-release参数，或在.versionrc中配置"scripts": { "posttag": "git push --follow-tags origin main" }
VSCode 终端中安全执行 npm version 的关键参数
npm version 是 Node.js 自带的轻量方案，适合简单项目，但容易踩坑。
必须明确指定类型和标签选项：
-
npm version patch→ 升修订号（如1.4.2→1.4.3），但默认创建轻量标签，且无v前缀 - 正确做法：
npm version patch -m "Release %s"→%s自动替换为新版本号，-m强制创建附注标签，并带v前缀（因为npm默认加v） - 推送时别用
git push origin --tags：它会把历史所有未推标签全发出去；应只推最新一个：git push origin $(git describe --tags --abbrev=0) - 如果
package.json里version是1.4.2，但你想跳过1.4.3直接发1.5.0，必须用npm version minor，不能手改package.json后再跑npm version，否则会报错
GitHub Actions 自动化里最容易被忽略的标签细节
即使本地用 standard-version 或 npm version 打了正确的附注标签，CI 流程仍可能失败，原因往往藏在 Git 配置里。
关键检查点：
- 工作流触发条件写的是
on: push: tags: ["v*"]，但你推的是1.5.0→ 不匹配，得改成["*"]或确保本地始终用v前缀 - CI 运行环境默认只 fetch 最近一次提交，
git describe会失败 → 必须在 job 开头加：fetch-depth: 0 -
vsce publish需要读取package.json的version字段，但如果你在 CI 里先打标签再改package.json（比如用sed），vsce会发布旧版本 → 正确顺序是：先改package.json→ 提交 → 打标签 → 推送 - GitHub Actions 默认不提供 GPG 签名能力，所以别在 CI 里试图用
git tag -s；附注标签（-a）已足够，签名只是可选增强
真正难的不是“怎么打标签”，而是让本地开发、VSCode 操作、CI 流水线、市场发布这四者对“哪个版本号对应哪次提交、哪个标签、哪个 vsix 包”达成完全一致。任何一环漏掉 v 前缀、用错标签类型、或没同步 package.json，都会导致用户看到的版本号、下载的包、文档里的 changelog 对不上。
