如何动态调整VS Code扩展package.json中的主入口？

方案1：用环境变量自动切换package.json的main字段 #

• 写个简单的Node脚本（比如switch-main.js），根据环境变量修改package.json的main值：

  const fs = require('fs');
  const pkg = require('./package.json');
  
  if (process.env.NODE_ENV === 'test') {
    pkg.main = './out/extension.js';
  } else {
    pkg.main = './dist/main.js';
  }
  
  fs.writeFileSync('./package.json', JSON.stringify(pkg, null, 2));
  

• 在package.json的脚本里添加触发逻辑：

  "scripts": {
    "pretest": "NODE_ENV=test node switch-main.js",
    "prepublishOnly": "NODE_ENV=production node switch-main.js",
    "test": "vscode-test-electron ...",
    "build": "esbuild ... && NODE_ENV=production node switch-main.js"
  }
  

• 原理：测试前自动切到extension.js，发布/生产构建前切回main.js，完全不用手动改。

方案2：拆分构建配置，为测试单独生成兼容入口 #

• 在esbuild配置里加一个测试专用的构建任务，生成能被测试访问导出的test-main.js：

  // esbuild.config.js
  require('esbuild').build({
    entryPoints: ['src/extension.ts'],
    bundle: true,
    outfile: './dist/main.js',
    platform: 'node',
    format: 'cjs',
    // 生产构建的常规配置
  }).catch(() => process.exit(1));
  
  // 只有测试环境才执行这个构建
  if (process.env.NODE_ENV === 'test') {
    require('esbuild').build({
      entryPoints: ['src/extension.ts'],
      bundle: true,
      outfile: './dist/test-main.js',
      platform: 'node',
      format: 'cjs',
      keepNames: true, // 保留变量名，方便测试识别导出
      sourcemap: true,
    }).catch(() => process.exit(1));
  }
  

• 修改测试启动脚本，指定用测试专用的入口文件，不用碰package.json的main：

  // test/runTest.js
  const { runTests } = require('@vscode/test-electron');
  const path = require('path');
  
  async function main() {
    try {
      const extensionDevPath = path.resolve(__dirname, '../');
      const extensionTestsPath = path.resolve(__dirname, './out/suite/index');
      // 直接指定测试用的扩展入口
      const launchArgs = [
        '--extensionDevelopmentPath', extensionDevPath,
        '--extensionTestsPath', extensionTestsPath,
        '--extensionMainPath', path.resolve(extensionDevPath, 'dist/test-main.js')
      ];
      
      await runTests({ extensionDevelopmentPath: extensionDevPath, extensionTestsPath, launchArgs });
    } catch (err) {
      console.error('测试运行失败');
      process.exit(1);
    }
  }
  
  main();
  

• 好处：生产包用main.js，测试用单独构建的test-main.js，两者完全隔离，不会把测试代码混进发布包。

方案3：让esbuild生成的main.js保留可被测试访问的导出 #

• 修改esbuild配置，确保打包后的main.js能暴露扩展导出：

  require('esbuild').build({
    entryPoints: ['src/extension.ts'],
    bundle: true,
    outfile: './dist/main.js',
    platform: 'node',
    format: 'cjs',
    banner: {
      js: 'globalThis.ExtensionExports = {};',
    },
    footer: {
      js: 'module.exports = globalThis.ExtensionExports;',
    },
  }).catch(() => process.exit(1));
  

• 在扩展源码里把需要测试的内容挂载到全局（仅测试环境生效）：

  import * as vscode from 'vscode';
  
  export function activate(context: vscode.ExtensionContext) {
    // 原有激活逻辑
  }
  
  export function deactivate() {}
  
  // 测试模式下暴露导出
  if (process.env.NODE_ENV === 'test') {
    (globalThis as any).ExtensionExports = { activate, deactivate };
  }
  

• 测试代码里直接通过globalThis.ExtensionExports访问扩展的导出函数，不用切换main字段。

内容的提问来源于stack exchange，提问作者Mike Lischke