VS Code扩展开发：源码变更后如何重载宿主窗口或热替换？

问题背景 #

我基于vscode-extension-samples/helloworld-sample开发VS Code扩展，当前开发流程如下：

• 运行「Develop Extension」启动配置时，tsc会以--watch模式监听文件变更，同时启动新的VS Code窗口作为扩展的宿主窗口
• 修改扩展源码（如extension.ts）后，手动按下Ctrl + R重载宿主窗口，能加载最新源码并更新扩展行为，符合预期

但目前存在以下问题：

• 源码更新后，宿主窗口的扩展行为无任何变化，必须手动重载
• 想了解两个方向的解决方案：
  1. 是否可以通过Hot Module Replace或其他方式，不用重载窗口直接修补宿主加载的源码？
  2. 有没有办法实现源码变更时自动重载宿主窗口？

当前使用的配置文件如下：

launch.json #

{
  "version": "0.2.0",
  "configurations": [{
      "name": "Develop Extension",
      "type": "extensionHost",
      "request": "launch",
      "runtimeExecutable": "${execPath}",
      "args": ["--extensionDevelopmentPath=${workspaceFolder}"],
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "preLaunchTask": "npm: dev",
      "postDebugTask": "Terminate All Tasks",
    },
  ]
}

tasks.json #

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "npm",
      "script": "dev",
      "detail": "Launch extension for local development in a new (host) VS Code window.",
      "problemMatcher": "$tsc-watch",
      "isBackground": true,
      "presentation": { "reveal": "always" },
      "group": {
        "kind": "build",
        "isDefault": true,
      },
      "icon": { "id": "tools" },
    },
    {
      "label": "Terminate All Tasks",
      "detail": "Stop all running tasks.", // e.g. useful for endless tasks like file watchers
      "command": "echo ${input:terminate}",
      "type": "shell",
      "problemMatcher": [],
      "icon": { "id": "stop-circle" },
    },
  ],
  "inputs": [
    {
      "id": "terminate",
      "type": "command",
      "command": "workbench.action.tasks.terminate",
      "args": "terminateAll",
    },
  ],
}

解决方案 #

1. 自动重载宿主窗口 #

VS Code官方支持通过配置实现源码变更后自动重载扩展宿主窗口，只需调整launch.json：
在你的扩展启动配置中添加"autoReload": true字段，修改后的配置如下：

{
  "name": "Develop Extension",
  "type": "extensionHost",
  "request": "launch",
  "runtimeExecutable": "${execPath}",
  "args": ["--extensionDevelopmentPath=${workspaceFolder}"],
  "outFiles": ["${workspaceFolder}/dist/**/*.js"],
  "preLaunchTask": "npm: dev",
  "postDebugTask": "Terminate All Tasks",
  "autoReload": true
}

该配置会让VS Code检测到dist目录下编译后的JS文件变更时，自动重载宿主窗口。需确保tsconfig.json中outDir设置为dist，且tsc --watch能正确将编译产物输出到该目录。

2. 关于Hot Module Replace（HMR） #

目前VS Code扩展开发不支持完整的HMR机制。扩展运行在VS Code的Extension Host进程中，该进程的模块加载机制限制了动态替换已加载模块的能力——即使手动尝试实现HMR，也无法处理已注册的命令、事件监听器等核心逻辑的动态更新。因此官方和社区普遍推荐使用自动重载窗口的方式更新扩展。

验证方法 #

修改extension.ts中的代码（比如调整Hello World命令的输出内容），保存后等待tsc编译完成，宿主窗口会自动重载，打开命令面板执行扩展命令即可看到更新后的效果。

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