ExtensionContext.subscriptions 是插件生命周期安全的强制边界，漏推会导致内存泄漏或崩溃；extensionUri 与 asAbsolutePath 用途严格区分；globalState 和 workspaceState 存储范围及序列化受限；secrets 仅用于敏感凭证且异步访问。
ExtensionContext.subscriptions 是资源管理的核心，不是可选的“好习惯”
几乎所有官方示例都把 disposable 推进 context.subscriptions，但很多人误以为这只是“推荐写法”。实际它是插件生命周期安全的强制边界：一旦插件被停用（比如用户禁用、VS Code 重启扩展宿主），context.subscriptions 会自动调用其中每个 Disposable 的 dispose() 方法。漏掉这一步，会导致监听器持续驻留、WebviewPanel 不销毁、定时器不清除——轻则内存泄漏，重则引发 Extension host terminated unexpectedly 错误。
常见漏推场景包括：
- 在
vscode.window.onDidChangeActiveTextEditor回调里新建的监听器，没用context.subscriptions.push() - 手动创建的
vscode.Disposable.from(...)实例，直接赋值给变量但未注册 - 调用
vscode.workspace.createFileSystemWatcher后返回的 watcher 实例，忘记推入
context.extensionUri 和 context.asAbsolutePath 的路径处理差异必须分清
context.extensionUri 返回的是 vscode.Uri 对象，用于访问插件内资源（如图标、HTML 模板）；而 context.asAbsolutePath(path: string) 是把它转成 Node.js 可读的绝对文件路径（string）。两者不能混用：
- 传给
vscode.Uri.file()或 Webview 的webview.asWebviewUri()必须用context.extensionUri衍生，不能用asAbsolutePath的结果 - 传给
fs.readFile、require()或子进程execFile的路径，必须用context.asAbsolutePath('./assets/icon.png')，否则会因 URI 格式（如file:///c%3A/...）导致读取失败 -
context.asAbsolutePath('')返回插件根目录路径，末尾不带斜杠；拼接子路径时建议用path.join()而非字符串拼接
context.globalState 和 context.workspaceState 的存储范围与序列化限制
两者都提供键值对持久化，但作用域和行为完全不同：
-
context.globalState：跨工作区全局生效，数据存在用户配置目录下（如~/.vscode/extensions/xxx/state.json），适合存用户偏好、授权 token 等个人设置 -
context.workspaceState：仅当前打开的文件夹/工作区有效，关闭该工作区后自动清理，适合存临时缓存、上次编辑位置等上下文相关状态 - 二者都只支持 JSON-serializable 值（
string、number、boolean、null、数组、纯对象），不能存Date、RegExp、函数或循环引用对象；存Date需先转toISOString() - 读取时务必用
get(key, defaultValue)并提供默认值，因为首次运行或数据损坏时可能返回undefined
context.secrets 不是通用加密存储，仅限敏感凭证类数据
context.secrets 提供的是操作系统级密钥链访问（Windows Credential Manager / macOS Keychain / Linux Secret Service），它不加密普通业务数据，也不保证跨平台行为一致：
- 只应存密码、API key、OAuth refresh token 等真正需要保密的凭证，不要用来存配置开关或调试标记
- 获取值是异步的（
await context.secrets.get('my-token')），不能在同步流程中使用 - Linux 下依赖
libsecret，若未安装或 dbus 服务异常，会静默降级为内存存储（重启即丢失），需在插件启动时做可用性探测 - 删除操作不可逆，且无批量清空接口；测试时建议用独立测试账号，避免污染用户真实凭据
context 本身——它不是静态配置容器，而是 VS Code 主进程注入的、带有严格生命周期约束的运行时上下文。任何脱离 activate() 函数作用域去缓存 context、或在 deactivate() 之后还尝试访问它的行为，都会触发不可预测的错误。 
