本地模型加载失败时，codewhisperer.localmodel.path 必须用绝对路径，因 vscode 的 llama.cpp 后端不解析 ~ 或 ./ 等相对路径，~/.vscode/models/xxx.gguf 会被字面处理导致文件未找到。

本地模型加载失败时，codeWhisperer.localModel.path 路径必须用绝对路径

VSCode 2026 的本地代码生成插件（如 CodeWhisperer Local）在启动时若报错 Failed to load model: file not found 或直接无响应，90% 是因为 settings.json 中的模型路径用了相对路径或波浪线 ~。VSCode 的 llama.cpp 后端不解析 shell 层的路径展开，~/.vscode/models/xxx.gguf 会被当作字面字符串处理，最终找不到文件。

• ✅ 正确写法（macOS/Linux）："codeWhisperer.localModel.path": "/Users/yourname/.vscode/models/codellama-13b.q5.gguf"
• ✅ 正确写法（Windows）："codeWhisperer.localModel.path": "C:\Users\yourname\.vscode\models\codellama-13b.q5.gguf"
• ❌ 错误写法："~/.vscode/models/..."、"./models/..."、../models/...
• 验证方式：在终端中直接 ls -l（macOS/Linux）或 dir（Windows）粘贴该路径，确保能定位到 .gguf 文件

vscode.window.activeTextEditor 返回 null 的真实原因和绕过方式

很多插件在调用 getCurrentContext() 时突然失效，提示 Cannot read property 'document' of null，不是因为用户没打开文件，而是 VSCode 在某些上下文（比如刚启动、侧边栏聚焦、调试控制台激活）下根本不会设置 activeTextEditor。它只在编辑器主区域有焦点且至少一个文本文件被打开时才非 null。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 必须加空值检查：if (!editor) return;，不能依赖“用户肯定开了文件”这种假设
• 更稳妥的 fallback：用 vscode.workspace.onDidChangeTextDocument 或 vscode.window.onDidChangeActiveTextEditor 监听变化，而非一次性读取
• 若需强制触发上下文（例如快捷键生成代码），应在 activationEvents 中声明 "onCommand:firstts.generate"，并确保命令注册逻辑不依赖 editor 初始化时机
• 注意：单元测试里 activeTextEditor 永远为 null，mock 必须手动注入

安全沙箱拦截 eval 和 process.exit 后，生成代码无法运行怎么办

VSCode 2026 默认启用 WebAssembly 安全沙箱，所有 AI 生成代码在插入前会做静态扫描 + 动态预执行验证。一旦检测到 eval、setTimeout（含隐式全局）、process.exit、fs.writeFileSync 等高危调用，整段建议会被丢弃——不是报错，而是静默跳过，导致开发者以为“没生成”，实际是被拦截了。

• 检查输出通道：打开 VSCode 的 Output 面板 → 切换到 CodeWhisperer Local 标签，搜索 sandbox blocked 关键字
• 临时调试：在 settings.json 中设 "codeWhisperer.sandbox.enabled": false（仅开发阶段，上线前务必关掉）
• 替代方案：用 Function 构造器代替 eval（仍受限），或把危险操作拆成用户确认步骤（如“是否写入 config.json？”弹窗 + 手动调用 fs）
• 关键点：沙箱规则不可绕过，但可自定义白名单——需修改插件源码中的 sandboxRules.ts，重新打包

为什么 contributes.commands 里注册的命令不响应右键菜单点击

你写了 firstts.getState 命令，也在 package.json 的 contributes.commands 里声明了，但右键菜单选中后没反应——问题不在命令本身，而在缺少 menus 配置。VSCode 不会自动把命令挂到右键菜单，必须显式声明上下文位置和触发条件。

• 正确配置示例（在 package.json 的 contributes 下）：

  "menus": {
    "editor/context": [
      {
        "when": "editorTextFocus && resourceExt == .ts",
        "command": "firstts.getState",
        "group": "navigation"
      }
    ]
  }

• when 条件必须精确：常见错误是写成 resourceLangId == typescript（应为 typescript），或漏掉 editorTextFocus 导致光标不在编辑器内时不可见
• 参数传递陷阱：右键菜单触发命令时，VSCode 默认传入的是 vscode.Uri 对象，不是字符串路径；fs.stat(uri.fsPath, ...) 才对，别直接用 uri.path
• 调试技巧：在命令 handler 开头加 console.log(arguments)，看实际收到什么参数

本地模型路径、上下文空值、沙箱拦截、菜单绑定——这四个点卡住的人最多。它们不报红错，但会让功能“看起来没生效”，排查时容易陷入日志大海。真正要盯住的，是 Output 面板对应插件的日志流，而不是 console 或 debugger。