VSCode扩展开发核心是掌握vscode模块API的高频用法：从activate入口初始化资源，注册命令并声明于package.json，安全操作文档内容，读取配置与状态，并遵循懒加载和防内存泄漏原则。
VSCode 扩展开发的核心是使用官方提供的 vscode 模块 API，它暴露了编辑器能力的入口，比如命令注册、状态栏控制、文档操作、配置读取等。入门关键不是学全所有接口，而是掌握几个高频、易上手的模块，并理解其生命周期和调用时机。
从激活函数（activate）开始
每个扩展必须导出一个 activate 函数，这是 VSCode 加载扩展时调用的入口。它接收一个 ExtensionContext 对象，用于管理资源（如注册的命令、订阅事件、存储临时数据）。
- 所有功能初始化（如注册命令、监听事件）都应放在 activate 中，不要延迟到用户点击才做准备
- 用 context.subscriptions.push() 管理可释放资源（如 Disposable 对象），避免内存泄漏
- 不要在 activate 里执行耗时操作（如网络请求、大文件解析），可改用懒加载或用户触发后执行
注册并响应命令（commands）
命令是用户与扩展交互最常见的方式，比如通过 Ctrl+Shift+P 输入指令，或绑定快捷键、添加右键菜单项。
- 用 vscode.commands.registerCommand() 注册，第一个参数是唯一命令 ID（推荐格式：publisher.extensionName.doSomething）
- 回调函数接收任意参数，常用于传递当前选中文本、光标位置或点击的树节点
- 在 package.json 的 contributes.commands 中声明命令，才能出现在命令面板；加 keybindings 可绑定快捷键
操作编辑器与文档（TextEditor & TextDocument）
大部分扩展需要读写代码内容，核心对象是 vscode.window.activeTextEditor 和它的 document 属性。
- editor.document.getText() 获取全文，editor.selection 获取当前选区，editor.edit() 是安全修改文本的唯一方式（不可直接赋值）
- 注意：activeTextEditor 可能为 undefined（如没有打开文件、焦点在设置页），务必判空
- 监听文档变化用 vscode.workspace.onDidChangeTextDocument，适合做实时校验或自动补全逻辑
读取配置与状态（Configuration & State）
用户偏好通过 vscode.workspace.getConfiguration() 读取，扩展自身状态可用 context.globalState（跨窗口持久）或 context.workspaceState（仅当前工作区）。
- 配置项需在 package.json 的 contributes.configuration 中定义 schema，否则无法在设置界面显示和编辑
- globalState 存储序列化数据（只支持基本类型和简单对象），敏感信息（如 token）建议用 vscode.env.openExternal() 引导用户手动输入
- 状态变更可通过 onDidChangeConfiguration 监听，适合动态调整行为（如开关日志输出）
基本上就这些 —— 不需要一开始就啃完全部 API 文档。从注册一个命令、读取当前文件内容、弹出一个提示消息开始，跑通一次完整流程，再逐步叠加功能。VSCode 的 API 设计清晰，错误提示也友好，多看官方示例（vscode-extension-samples）比查文档更快上手。
