VSCode tasks.json 中 protoc 命令报“file not found”根本原因是 cwd 默认为工作区根目录，而 --proto_path 和输入路径需相对于该 cwd 解析；必须显式设 "cwd" 为 proto 目录或统一用 ${workspaceFolder} 拼接路径，并确保 --proto_path 包含所有 import 路径。

VSCode 的 tasks.json 能自动触发 Protobuf 编译，但默认不感知 .proto 文件变更，且容易因路径、插件或生成目标错位导致 protoc 执行失败或输出乱入源码目录。

为什么 tasks.json 里写 protoc 命令总报 “file not found”

根本原因是 VSCode 任务默认工作目录（"cwd"）是打开的文件夹根目录，而 protoc 的 --proto_path 和输入 .proto 路径若写相对路径，会相对于该 cwd 解析——不是相对于 tasks.json 所在位置，也不是相对于当前编辑的 .proto 文件。

• 务必显式设置 "cwd" 为 proto 文件所在目录（如 "${workspaceFolder}/proto"），或统一用绝对路径变量（如 "${workspaceFolder}"）拼接所有路径
• protoc 的 --proto_path 必须包含所有被 import 的 proto 文件所在目录，否则报 File not found
• 避免在命令中直接写 ./xxx.proto；改用 "${fileBasename}" 或 "${file}"，并确保 "group" 设为 "build" 以便和保存操作联动

如何让保存 .proto 时自动运行 protoc 且只编译当前文件

关键在 "type": "shell" + "problemMatcher" + 正确的触发条件。VSCode 不支持“仅当编辑 .proto 时触发”，所以得靠 "runOnSave": true 配合文件过滤逻辑实现效果。

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

• 在 tasks.json 中添加 "isBackground": true 和 "problemMatcher": ["$protoc"]（需先配置好 protoc matcher）
• 命令体推荐： protoc --proto_path=${workspaceFolder} --python_out=${workspaceFolder}/gen ${file}
• 必须加 "group": "build"，否则无法绑定到“保存时运行任务”功能
• 启用方式：右键编辑器 → “在保存时运行任务” → 选中你的 task；或手动执行 Tasks: Run Task → 选对应项

protoc 生成的代码进错了目录，或覆盖了手写文件怎么办

Protobuf 生成是覆盖行为，且 protoc 不校验目标目录是否存在或是否为空。常见错误是把 --go_out 或 --ts_out 指向了源码主目录，导致生成文件混入业务逻辑。

• 严格分离：约定一个专用输出目录，如 ${workspaceFolder}/gen/python、${workspaceFolder}/gen/go，并在 gitignore 中加入该路径
• Go 用户注意：--go_out 后必须跟 plugins=grpc:（新版语法），且 go_package option 决定包路径，与输出目录无关——别指望靠目录结构绕过 go_package
• TypeScript 用户如果用 ts-proto，命令要写成 protoc --plugin=protoc-gen-ts_proto=... --ts_proto_out=...，不能漏掉 --plugin 路径

最常被忽略的是 protoc 版本兼容性：protoc 3.21+ 默认禁用旧版 js_out，而 grpc-web 插件可能依赖特定版本；建议在 tasks.json 中显式调用带完整路径的 protoc（如 ${env:HOME}/bin/protoc），而不是只写 protoc。