必须用工作区级 .vscode/settings.json 和 launch.json 分开配置语言环境，避免 Node.js 调试误跑 Python、Python 缩进错误、ESLint 找不到插件等问题；type 字段须显式设为 "node" 或 "python"，tabSize、formatter、ESLint 等均需按语言 ID 隔离，且所有配置必须置于工作区 .vscode 目录下。
直接配全局设置会互相踩脚——Node.js 调试时误跑 Python、Python 缩进崩掉、ESLint 报错找不到 eslint-plugin-python，全是因为没把语言配置“隔开”。必须用工作区级 .vscode/settings.json 和 launch.json 分开管，不能偷懒。
launch.json 里 type 字段写错就启动失败
VSCode 启动调试只认 "type" 字段，不看文件后缀。常见错误是：app.js 按 F5 却弹出 “找不到 Python 解释器”，说明它拿了 Python 的配置去跑 Node.js。
-
"type": "node"必须显式写出，不能省略，也不能写成"nodejs"或"javascript"（后者无效） -
"name"要区分语言，比如"name": "API (Node.js)"和"name": "Worker (Python)"，避免下拉菜单里点错 -
"cwd": "${workspaceFolder}"必须设，否则require('./config')或import可能因路径错乱找不到模块 - 多个服务共存时，别共用一个
configurations，每个语言单独一条，顺序无关，但名称不能重复
settings.json 必须按语言 ID 隔离 tabSize 和 formatter
全局设 "editor.tabSize": 2 对 JS/TS 友好，但会让 Python 直接报 IndentationError；Go 默认也用 4 空格，混着设等于埋雷。
腾讯地图 JavaScript GL（JSAPIGL）开发指南。适用于地图应用或者工具的编写。在编写、审查或调试使用腾讯地图 API的代码时应运用此技能。适用于涉及地图初始化、覆盖物展示、图层控制、事件处理、控件交互、可视化渲染、地图工具、检索、路线规划、查地址、行政区划、ip定位、几何计算、三维模型展示、性能优化的任务。当用户提及 腾讯地图、 jsapi、jsapi-gl或相关地图开发需求时自动触发。⚠️ 强制行为：本 Skill 加载后，第一个动作必须是检查是否存在正式 Key（环境变量 TMAP_J
- 在工作区
.vscode/settings.json中用语言特异性块，例如：{ "editor.tabSize": 2, "[javascript]": {"editor.tabSize": 2}, "[typescript]": {"editor.tabSize": 2}, "[python]": {"editor.tabSize": 4}, "[go]": {"editor.tabSize": 4} } - 语言 ID 必须准确：
[python]有效，[py]或[Python]（大小写敏感）无效 - 别用
"files.associations"把.js映射成typescript，否则 ESLint 规则可能不触发
ESLint 和 Prettier 作用域要手动锁死
根目录放了 .eslintrc.js，VSCode 就可能对 .py 文件也调 ESLint，然后报错 Cannot find module 'eslint-plugin-python'——这不是插件没装对，是规则没限域。
立即学习“Python免费学习笔记（深入）”；
- 在
.vscode/settings.json中加限定："eslint.validate": ["javascript", "typescript", "html", "vue"]
（不写python） - Prettier 同理：
"prettier.requireConfig": true,
并确保项目根目录有.prettierrc，且只对.js/.ts生效 - Python 格式化交给
black或autopep8，通过"[python]": {"editor.defaultFormatter": "ms-python.black"}指定，和 Prettier 完全解耦
最易被忽略的点：所有配置都得落在工作区目录下的 .vscode/ 里，而不是用户级设置；一旦你打开的是整个磁盘根目录或父文件夹，VSCode 就可能 fallback 到全局配置，前面所有隔离 effort 全白费。
