tasks.json 必须放在工作区根目录的 .vscode/ 文件夹下，多根工作区需每个文件夹单独配置；路径错误、命名错误或隐藏文件夹未显示是菜单为空的主因。

tasks.json 文件该放在哪里才能被 VSCode 识别

VSCode 只会在工作区根目录下的 .vscode/tasks.json 中加载任务配置，不存在“全局生效”或“项目子目录自动继承”的行为。如果你在多文件夹工作区（比如用 File > Add Folder to Workspace 添加了多个根），每个文件夹需各自提供独立的 .vscode/tasks.json，否则对应文件夹的任务不会出现。

常见错误现象：Terminal > Run Task 菜单里空空如也，或只显示 Shell / npm 等默认任务，但你明明写了 tasks.json —— 很可能它被放在了子目录、或文件名拼错了（比如写成 task.json 或 Tasks.json）。

• 确认路径是 .vscode/tasks.json（注意 .vscode 是隐藏文件夹，Windows 资源管理器可能默认不显示）
• 如果使用多根工作区，tasks.json 必须放在每个具体文件夹下，不能只放在工作区代码空间顶层
• 修改保存后无需重启 VSCode，但任务列表不会自动刷新；可按 Ctrl+Shift+P → 输入 Tasks: Manage Task 触发重载

怎么写一个能直接运行 shell 命令的任务（比如启动 dev server）

最常用场景就是封装 npm run dev 或 python -m http.server 这类命令，避免反复敲终端。关键不是“能不能”，而是「要不要走 shell 封装层」—— 直接调用命令更可靠，绕过 shell 解析可避免引号、空格、环境变量等歧义。

推荐用 shell 类型（适合带管道/重定向/多命令）或 process 类型（更轻量、跨平台兼容性更好）。不要用 shell 类型却只写单个命令，那反而多了一层不必要的进程。

dmap-jsapi-skill

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

下载

• 用 process 类型运行 npm 脚本：

  {
    "version": "2.0.0",
    "tasks": [
      {
        "label": "npm: dev",
        "type": "process",
        "command": "npm",
        "args": ["run", "dev"],
        "group": "build",
        "presentation": {
          "echo": true,
          "reveal": "always",
          "focus": false,
          "panel": "shared",
          "showReuseMessage": true
        }
      }
    ]
  }

• shell 类型适合需要 && 或 | 的场景，例如："command": "npm run build && python -m http.server 8000"
• Windows 下若遇到 Command failed: npm run dev 但终端里能跑，大概率是没配 "windows": { "options": { "shell": { "executable": "cmd.exe" } } }，或者 npm 不在 PATH 里（建议用完整路径如 C:\Program Files\nodejs\npm.cmd）

如何让任务自动触发、或绑定快捷键运行

VSCode 本身不支持“保存即运行任务”，但可通过扩展（如 Gruntfuge.vscode-auto-run-command）或监听文件变化 + 自定义脚本实现；更稳妥的做法是把高频任务设为“默认构建任务”，再用快捷键 Ctrl+Shift+B 触发。

绑定快捷键要改的是 keybindings.json，不是 tasks.json。重点在于任务的 label 必须完全匹配（包括空格和大小写）。

• 打开命令面板 Ctrl+Shift+P → 输入 Preferences: Open Keyboard Shortcuts (JSON)
• 添加一条：

  [
    {
      "key": "ctrl+alt+d",
      "command": "workbench.action.terminal.runActiveFile",
      "when": "terminalFocus"
    },
    {
      "key": "ctrl+alt+b",
      "command": "workbench.action.terminal.sendSequence",
      "args": { "text": "npm run buildu000D" },
      "when": "terminalFocus"
    }
  ]

  （注意 u000D 是回车符）
• 更规范的方式是调用 workbench.action.terminal.runSelectedTask 并指定 label：

  {
    "key": "ctrl+alt+t",
    "command": "workbench.action.terminal.runSelectedTask",
    "args": { "name": "npm: dev" }
  }

• 别忘了检查 when 条件：比如 terminalFocus 表示仅在终端聚焦时生效；想全局可用就删掉 when 字段

为什么任务输出乱码、卡住、或不自动关闭终端

本质是 VSCode 终端对子进程的控制粒度有限。它不接管 stdin/stdout 缓冲策略，也不判断“程序是否真的结束了”。所以像 nodemon、webpack serve 这类长期运行的服务任务，容易出现「终端卡住」「无法再次运行」「中文日志变问号」等问题。

• 乱码（尤其是中文）：Windows 默认 cmd 是 GBK 编码，而 Node.js / Python 默认 UTF-8。在 tasks.json 的 presentation 里加 "env": { "PYTHONIOENCODING": "utf-8" }，或统一用 PowerShell（UTF-8 默认）作为终端
• 任务卡住不退出：在 presentation 中设置 "panel": "dedicated"（每次新开独立终端），并开启 "clear": true 避免残留输出干扰
• 想关掉正在运行的任务？快捷键 Ctrl+Shift+P → Terminal: Kill the Active Terminal Instance，或右键终端标签页选 Kill Terminal；没有“一键终止所有任务”的内置功能
• 某些任务（如 docker-compose up）会持续占用终端且无法被 VSCode 正确识别结束状态，此时建议改用外部终端，或用 isBackground: true + problemMatcher 模拟后台任务（但配置复杂，普通用户慎入）

真正难处理的从来不是怎么写 JSON，而是搞清「这个命令在什么上下文里执行」「它的生命周期谁来管」「输出流有没有被截断或缓冲」——这些细节不验证一遍，光靠复制粘贴配置，迟早会在某次 npm 升级或系统更新后突然失效。