devcontainer.json必须显式声明remoteUser和sourceMount：设"remoteUser":"vscode"确保插件依赖的$HOME路径可用，配"sourceMount":"local"使本地源码实时映射进容器。
devcontainer.json 必须显式声明 remoteUser 和 sourceMount
VSCode 插件本身是运行在宿主机上的，但插件开发时若想调试“插件在容器中如何行为”，就得让插件的测试运行环境也进容器——这和普通项目不同：你不是在容器里写 Python 或 Node.js 应用，而是在容器里启动一个 VSCode 实例（或 Code Server），再加载你的插件进行端到端验证。
常见静默失败点是：remoteUser 没设，默认为 root，但很多插件依赖非 root 用户的 $HOME 路径存放扩展缓存、日志或配置；sourceMount 没配，导致你改了本地插件源码，容器里 vscode 进程根本看不到更新。
-
"remoteUser": "vscode"是安全起点，配合createRemoteUser: true自动建用户 -
"sourceMount": "on"（或显式写"sourceMount": "local"）才能让./src和./package.json实时映射进容器 - 别用
image: "mcr.microsoft.com/vscode/devcontainers/base:ubuntu"—— 它没预装code-server或 VSCode CLI，得自己curl下载并配置PATH
调试插件主进程需暴露 --inspect-extension-host 端口
插件调试本质是调试一个 Electron 渲染进程 + 一个 Node.js 扩展主机进程。VSCode 容器内运行时，必须让扩展主机开启远程调试协议，否则你在宿主机 VSCode 里点“Attach to Extension Host”会连不上。
关键不是改 launch.json，而是改容器启动命令：
- 在
devcontainer.json的runArgs里加："--inspect-extension-host=0.0.0.0:9229" - 同时在
forwardPorts列表里加上9229，否则宿主机无法访问该端口 - 确保容器里安装了
codeCLI（不是code-server）：推荐用mcr.microsoft.com/vscode/devcontainers/typescript-node:18镜像，它自带code命令行工具 - 启动容器后，在容器终端执行：
code --extensions-dir /tmp/ext --extensionDevelopmentPath /workspace/my-extension --inspect-extension-host，这是最接近真实调试链路的命令
package.json 的 activationEvents 在容器里可能不触发
本地开发时，打开一个 .ts 文件就能激活插件；但在容器里，如果工作区路径没被正确识别为 TypeScript 项目（比如没挂载 tsconfig.json，或没装 @types/node），"onLanguage:typescript" 这类 activationEvent 就不会响。
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
这不是 bug，是容器环境缺失语言服务器上下文导致的。解决方式很直接：
- 把
tsconfig.json、node_modules（或至少package-lock.json）一并挂载进容器，不要只挂src - 在
devcontainer.json的postCreateCommand里补一句：npm install --no-save，确保类型定义就位 - 临时把
activationEvents改成*测试逻辑是否正常，确认后再切回精确事件 - 检查容器里
process.env.VSCODE_IPC_HOOK是否存在 —— 缺失说明 VSCode 启动流程异常，大概率是codeCLI 版本太低或权限问题
容器内调试插件时，断点失效的真正原因常是 sourcemap 路径错位
你打了断点，代码也跑到了那行，但就是不中断。90% 情况下不是配置漏了，而是 VSCode 调试器找不到原始 TS 文件对应位置。
因为编译后的 JS 在容器里路径是 /workspace/out/extension.js，但 sourcemap 里写的却是 ../../src/extension.ts —— 这个相对路径在容器里解析出来是错的。
- 在
tsconfig.json中强制指定："sourceRoot": "/workspace/src"，让所有 sourcemap 统一指向绝对路径 - 在
devcontainer.json的customizations.vscode.settings里加："typescript.preferences.importModuleSpecifier": "relative"，避免自动补全引入路径干扰构建 - 验证方式：在容器里打开生成的
out/extension.js，搜sourceMappingURL，确认末尾的//# sourceMappingURL=...指向的.map文件能被cat读到，且 map 文件里的sources字段是完整绝对路径
容器化调试插件最难缠的不是配置项，而是“你以为在容器里，其实某些路径解析仍在宿主机上下文”。每次断点不命中，先 cat 一眼 sourcemap 内容，比重装插件快十倍。
