VSCode 无法调试微信小程序，所有调试功能（断点、console、WXML渲染、wx.login等）必须由微信开发者工具完成；VSCode仅作编辑与类型支持，需配合构建、路径对齐和sourceMap才能协同调试。
先说一个核心判断：VSCode 本身不提供微信小程序调试能力。那些号称“微信小程序插件”的扩展，没有一个能让你在 VSCode 里启动模拟器、设断点、看 WXML 渲染或调用 wx.login——这些活儿，必须由微信开发者工具亲自完成。安装任何名字带“微信小程序开发”的扩展，都只是补全、高亮、文件关联这类辅助功能，不是调试入口。这一点，要先搞清楚。
装了“minapp”扩展后 .wxml 还是没语法提示
很常见的现象：装完 minapp（作者 qiu8310）之后，发现标签闭合校验、属性补全、WXS 跳转全都没有，Ctrl+Click 点不进组件定义。这通常不是插件本身的问题，而是几个细节没对齐。
- 确认 VS Code 已重启——minapp 启动需要完整加载语言服务，重启是最基本的。
- 手动触发语言模式切换：
Ctrl + Shift + P→ 输入Change Language Mode→ 回车 → 选WXML。如果没出现这个选项，说明 minapp 未生效或被禁用。 - 在项目根目录的
.vscode/settings.json中强制关联文件类型：{"files.associations": {"*.wxml": "wxml"}} - 避免装多个 WXML 插件——比如 “WeApp MiniProgram”、“vscodewxml” 这些，它们会互相冲突，覆盖 minapp 的语言服务。
为什么装了插件，但 Page({}) 里 data 还标红、onLoad 参数是 any
这跟插件没关系，是类型系统没对齐。VSCode 不知道 Page 是什么，也不认识 options 的结构。解决起来也不复杂。
- 必须安装类型声明包：
npm install --sa ve-dev @types/wechat-miniprogram。注意：别用miniprogram-api-typings，它已经停止维护，而且与基础库 3.x+ 不兼容。 - 确保
tsconfig.json中包含："types": ["wechat-miniprogram"]
- 对页面加泛型才能推导
onLoad参数：Page<{ id: string }>({ onLoad(options) { console.log(options.id); } }) - 如果用的是
uni-app，则应换用@uni-helper/uni-app-types，而非微信原生类型。
装了插件，但保存 .ts 文件后微信开发者工具不刷新
这是最容易被误认为“插件失效”的场景。本质上是构建链路断裂了：VSCode 编辑的是 .ts，微信工具运行的是 .js，中间缺了编译这一步。
- 检查
project.config.json中的miniprogramRoot是否指向实际输出目录（比如./dist/miniprogram），而不是源码目录（比如./src）。 - 确认你有运行构建命令（如
npx tsc -w或npm run build:mp），并且输出路径和微信工具读取的路径一致。 - 禁用微信开发者工具里的「ES6 转 ES5」和「增强编译」——这两项会干扰 sourceMap 映射，导致 VSCode 断点失效。
- 不要在
miniprogram/目录下混写.ts和.js，否则微信工具可能加载旧的.js而忽略新编译结果。
真正容易被忽略的点是：所有调试行为（console、断点、setData 变量监视、WXML 实时高亮）都发生在微信开发者工具进程内，VSCode 只负责把代码写对、存好、类型标清。路径对齐、sourceMap 开启、构建命令持续运行——这三件事没做对，装再多插件也白搭。
