如何从Jenkins获取构建号并在VSCode扩展中追踪VSIX版本

完全可以通过Jenkins构建号、Git提交哈希等唯一标识来追踪VSIX对应的构建记录，以下是几种落地的实现方案：

1. 重命名VSIX文件，嵌入构建信息 #

这是最直观的方式，让测试人员从文件名就能快速识别构建版本。在Jenkins构建脚本中，打包完成后直接修改文件名，注入Jenkins环境变量：

• 可用的核心变量：BUILD_NUMBER（当前构建的序号）、GIT_COMMIT（当前代码提交的完整哈希，取前7位足够区分）
• 示例脚本（基于vsce打包工具）：

# 执行VSCode插件打包
vsce package
# 重命名VSIX文件，加入构建号和提交哈希前缀
mv your-extension.vsix your-extension-build-${BUILD_NUMBER}-${GIT_COMMIT:0:7}.vsix

2. 动态修改插件版本号，绑定构建标识 #

VSCode插件的package.json中的version字段支持语义化版本的扩展格式，可以把构建号嵌入版本号中：

• 方案一：用构建号替换补丁版本（比如1.0.0 → 1.0.${BUILD_NUMBER}）
• 方案二：添加构建后缀（比如1.0.0 → 1.0.0+build${BUILD_NUMBER}）
• 示例脚本（用jq工具修改JSON文件）：

# 方案一：替换补丁版本
jq --arg build "$BUILD_NUMBER" '.version = "1.0." + $build' package.json > temp.json && mv temp.json package.json
# 方案二：添加构建后缀
jq --arg build "$BUILD_NUMBER" '.version |= . + "+build" + $build' package.json > temp.json && mv temp.json package.json

打包安装后，测试人员可以在VSCode的「已安装扩展」列表中直接看到带构建号的版本信息。

3. 插件内部添加构建元数据，支持运行时查询 #

在package.json中添加自定义字段存储Jenkins构建详情，再通过插件命令暴露给用户：

• Jenkins构建时注入元数据：

jq --arg build "$BUILD_NUMBER" --arg commit "$GIT_COMMIT" --arg time "$BUILD_TIMESTAMP" \
  '.jenkinsBuildInfo = {buildNumber: $build, gitCommit: $commit, buildTime: $time}' \
  package.json > temp.json && mv temp.json package.json

• 插件代码中添加命令展示信息（TypeScript示例）：

import * as vscode from 'vscode';
import * as packageJson from './package.json';

export function activate(context: vscode.ExtensionContext) {
    const showBuildInfo = vscode.commands.registerCommand('your-extension.show-build-info', () => {
        const buildInfo = (packageJson as any).jenkinsBuildInfo;
        vscode.window.showInformationMessage(
            `Jenkins构建详情:\n构建号: ${buildInfo.buildNumber}\nGit提交哈希: ${buildInfo.gitCommit}\n构建时间: ${buildInfo.buildTime}`
        );
    });
    context.subscriptions.push(showBuildInfo);
}

测试人员只需打开命令面板（Ctrl+Shift+P），执行「Show Build Info」就能查看当前插件对应的Jenkins构建记录。

4. Jenkins构建工件关联 #

在Jenkins中配置构建后上传VSIX到构建工件，这样测试人员从Jenkins的具体构建页面下载时，页面本身就会显示构建号、提交信息，天然完成版本与构建的绑定。

内容的提问来源于stack exchange，提问作者Thejas Jain M j