插件需从语言模式、选区、ast节点等明确信号响应上下文，避免仅依赖光标前文本；应注册独立补全提供器区分意图，异步调用本地模型并适配项目格式规范。
如何让插件响应不同代码上下文触发生成逻辑
VSCode 插件不能靠“猜”来决定生成什么，必须明确从当前编辑器状态中提取可判定的信号。常见错误是只检查光标前文本（linePrefix），但忽略语言模式、选区范围、AST节点类型等关键上下文。
实操建议：
- 优先用
vscode.window.activeTextEditor?.document.languageId判断语言，避免在 Python 文件里匹配console.log - 对选中文本调用
vscode.languages.setTextDocumentLanguage()防止语言 ID 错误导致 AST 解析失败 - 使用
vscode.languages.parseDocument()（需启用 Tree-sitter）获取 AST 节点类型，比正则更可靠 —— 例如检测是否在函数体内部、是否处于 return 语句后 - 若项目已配置
tsconfig.json或pyproject.toml，可读取其路径判断项目规范，决定生成风格（如是否加类型注解）
补全提供器里怎么区分“生成函数体”和“生成测试用例”
同一个触发字符（比如 . 或 @）不能混用两种逻辑，否则用户会困惑。必须把意图显式暴露出来，而不是靠模型“理解”。
实操建议：
- 不要复用
vscode.CompletionItemProvider处理所有场景；为不同目的注册独立提供器，例如：registerCompletionItemProvider('typescript', new FunctionBodyCompleter(), '{')和registerCompletionItemProvider('typescript', new TestCaseCompleter(), 'it(') - 利用
triggerKind参数区分手动触发（vscode.CompletionTriggerKind.Invoke）与自动触发（vscode.CompletionTriggerKind.TriggerCharacter），前者适合交互式生成（如右键菜单），后者适合隐式补全 - 在
provideCompletionItems中检查position所在行是否含关键词：如匹配/describe\(/则走测试生成逻辑，匹配/function\s+\w+\s*\(/则走函数体生成 - 避免在补全项里塞大段代码（如整个 test 块），改用
vscode.SnippetString+ 占位符，让用户能 tab 跳转编辑
本地模型调用时怎么避免阻塞 UI 线程
直接在 provideCompletionItems 里同步调用本地模型（如 GGUF 加载的 CodeLlama-13B-Instruct-GGUF）会导致 VSCode 卡死，尤其在低内存设备上。
实操建议：
- 所有模型推理必须异步，且设超时：用
AbortController控制请求生命周期，例如const controller = new AbortController(); setTimeout(() => controller.abort(), 3000); - 不要在主线程加载模型权重；启动时用
WebAssembly.instantiateStreaming()预加载，或通过Worker隔离计算 —— VSCode 2026 支持vscode.worker模块 - 缓存最近 3 次生成结果（按
languageId + linePrefix.substring(0, 50)哈希），避免重复请求；但注意缓存键要排除动态变量名 - 返回空数组前先发一个带 loading 状态的
CompletionItem（kind: vscode.CompletionItemKind.Text,label: 'Generating…'），让用户感知正在工作
为什么生成的代码常被 ESLint 或 Prettier 报错
不是模型错了，是插件没对齐项目的代码规范。很多插件生成后直接插入，却没走格式化管道，导致缩进、分号、引号风格不一致。
实操建议：
- 生成完代码后，调用
vscode.commands.executeCommand('editor.action.formatDocument')触发当前编辑器格式化（需提前检查用户是否启用了格式化工具） - 读取
.eslintrc.*或.prettierrc文件内容，提取singleQuote、semi等配置，让生成逻辑适配（例如生成时主动加/不加分号） - 对 TypeScript 文件，用
ts.createSourceFile()解析生成代码再校验语法，比依赖 ESLint 更快；失败时返回null而非抛错 - 不要硬编码缩进为 2 或 4 空格；查
vscode.workspace.getConfiguration('editor').get('insertSpaces')和tabSize
