如何仅在打开工作区时激活VS Code扩展？

核心思路 #

通过针对性的激活事件，让扩展仅在满足「有工作区文件夹+storageUri可用」的条件时才激活，彻底避免无意义的激活状态。

推荐的激活事件配置 #

直接使用workspaceContains:**/*作为激活事件，它会在以下场景触发：

• 打开包含至少一个文件/文件夹的工作区（空工作区或无工作区不会触发）
• 切换到符合条件的新工作区

此时激活扩展时，ExtensionContext.storageUri必然是已定义的——因为VS Code仅在有工作区文件夹的情况下，才会给扩展分配storageUri。

在package.json中配置：

"activationEvents": [
  "workspaceContains:**/*"
]

进阶优化：结合命令触发 #

如果你的扩展是通过用户执行命令来使用的，建议同时搭配onCommand事件，进一步优化激活时机：

"activationEvents": [
  "onCommand:your-extension.your-command-id",
  "workspaceContains:**/*"
]

这样扩展会在两种场景激活：

1. 用户打开符合条件的工作区时自动激活
2. 用户触发扩展命令时（此时若工作区不符合条件，VS Code不会激活扩展，命令也不会执行）

为什么放弃onStartupFinished #

onStartupFinished会在VS Code启动完成后无条件触发，包括无工作区的场景，这会导致扩展激活后没有可用功能，既浪费资源又不符合扩展的设计逻辑，完全没必要用它。

额外说明 #

如果担心工作区在扩展激活后被清空（极端场景），可以在核心功能入口做一次极简检查：

if (!context.storageUri || vscode.workspace.workspaceFolders?.length === 0) {
  vscode.window.showErrorMessage("请打开包含文件夹的工作区使用该扩展");
  return;
}

但这种情况极少发生，因为激活事件已经过滤了绝大多数不符合条件的场景。

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