vscode需配置才能高效开发微信小程序：须手动关联wxml/wxss文件类型、安装官方类型包miniprogram-api-typings、正确设置source map与调试配置，否则语法提示、类型检查、断点调试等功能均失效。
VSCode 本身不运行、不编译、不调试微信小程序，它只负责写代码；所有预览、真机调试、性能分析必须用微信开发者工具完成。用对插件和配置，才能让 VSCode 真正“好用”——否则你连 wx:for 补全都看不到，app.json 校验报红也查不出原因。
装 minapp 插件但 WXML 还是纯文本？必须手动关联语言模式
VSCode 默认把 .wxml 当作未知文件类型，不触发任何语法支持。装了 minapp（作者 qiu8310）也不起作用，除非你告诉它“这是 HTML 类文件”。
- 打开项目根目录的
.vscode/settings.json（没有就新建），加这行："files.associations": {"*.wxml":"html","*.wxss":"css"} - 别信“自动识别”，不配这句，WXML 标签不闭合、属性不提示、
<view wx:if="{{a}}"> 里 <code>wx:if根本不补全 - 如果用了
minapp-vscode，它默认依赖这个关联；不配，它的格式化、跳转、变量高亮全失效
TS 类型提示标红或 wx. 没补全？官方类型包不能用社区版
@types/wechat-miniprogram 社区维护版长期滞后，基础库升到 3.x 后，getOpenUserInfo、chooseMedia 等新 API 直接报错。VSCode 不是没识别，是类型定义根本没覆盖。
- 装微信官方维护的
miniprogram-api-typings：npm install --save-dev miniprogram-api-typings - 在项目根目录建
types/文件夹，把node_modules/miniprogram-api-typings/index.d.ts软链或复制进去 -
tsconfig.json中明确写："typeRoots": ["./types", "./node_modules/@types"] -
Page({ onLoad(options) { } })的options默认是any，得显式写成Page({ onLoad(options) { } })
保存后微信开发者工具不刷新，或断点打不中？不是插件问题，是文件没落盘或 source map 没对齐
VSCode 编辑的是内存缓冲区，微信开发者工具只读磁盘文件；断点命中依赖源码映射关系，不是靠“连上调试器”就行。
- 确保 VSCode 设置里关掉了
files.autoSave的 delay 模式，用onFocusChange或onWindowChange，避免改完没保存 - 微信开发者工具需打开「调试器」→「调试」→ 勾选「启用远程调试」（默认端口
9229） - VSCode 的
launch.json别手写type: "node"，直接用minapp提供的Launch MiniProgram预设配置 - 首次调试前，务必先在微信开发者工具里点一次「编译」，否则 VSCode 启动调试会静默失败，无任何错误提示
console.log 输出看不见？日志不在 VSCode 的 Debug Console 里
小程序 JS 全部跑在微信开发者工具的 WebView 或真机环境里，VSCode 的 Debug Console 是 Node.js 进程的输出，跟小程序完全无关。
-
console.log只出现在微信开发者工具右上角「调试器」→「Console」面板 - 如果没看到输出，先确认是否点了「清空」、是否过滤了 log 级别、是否在正确页面生命周期里调用
- 不要在
App()外层直接写console.log，它可能执行时机早于环境初始化，被丢弃
最常被忽略的一点：微信开发者工具导出的 project.config.json 含本地绝对路径和 debugOptions 字段，在 VSCode 里会触发 schema 校验失败。删掉这两项再用，否则 minapp 会降级为仅语法高亮，连 app.json 的 pages 校验都失效。
