VSCode仅作编辑器，小程序运行调试必须用微信开发者工具；需手动关联.wxml/.wxss语言模式、安装minapp插件、配置官方类型定义、确保保存生效、禁用Prettier对wxml格式化。
VSCode 不能运行或调试微信小程序，它只是编辑器；所有编译、预览、真机调试必须用微信开发者工具。配置的核心目标是：写得顺、提示准、不报错、保存即生效。
为什么改了代码没反应，或者 WXML 里属性不补全
根本原因不是插件没装，而是 VSCode 根本没把 .wxml 和 .wxss 当作代码文件处理——默认当纯文本，自然没高亮、没闭合校验、没属性提示。
实操建议：
- 打开
settings.json（Ctrl+, → 点右上角“在 settings.json 中编辑”），加这两行："*.wxml": "html",<br>"*.wxss": "css"
- 装
minapp插件（作者 qiu8310），它是目前唯一持续维护、支持标签 + API 双补全的扩展 - 确保项目根目录有
project.config.json，否则minapp会降级为仅语法高亮 - 别信“自动识别”宣传，这步手动关联语言模式跳过，后面所有智能提示都打折
TS 类型提示失效，Page 参数标红或 wx. 没补全
不是插件坏了，是缺少微信官方类型定义。社区版 @types/wechat-miniprogram 版本滞后严重，和基础库 3.x+ 不兼容，常见 getOpenUserInfo 报错就是它导致的。
实操建议：
- 装微信官方维护的
miniprogram-api-typings：npm install --save-dev miniprogram-api-typings - 项目根目录建
types/文件夹，把miniprogram-api-typings的index.d.ts放进去（或直接引用 node_modules） -
tsconfig.json里明确写："compilerOptions": {<br> "typeRoots": ["./types", "./node_modules/@types"]<br>} -
Page的onLoad参数要类型安全？显式加泛型：Page(...)，不然options.id就是any
保存后微信开发者工具不自动刷新，或断点不命中
VSCode 不监听未保存的文件，微信开发者工具也不读取内存中的变更——它只读磁盘文件。而断点不命中，90% 是 source map 没对上，不是调试器没连上。
实操建议：
- 务必手动
Ctrl+S（Win）或Cmd+S（Mac）保存，别依赖 autosave 延迟——微信工具不会等你那 1 秒 - 如果用了 TypeScript 或构建工具（如 webpack），确保构建命令开了
sourceMap: true，且输出路径（如miniprogram/）和微信开发者工具设置的miniprogramRoot完全一致 - 不要在
miniprogram/目录里混写.ts和.js，微信工具可能加载旧的.js而忽略新编译结果 - 调试时看日志，必须打开微信开发者工具右上角「调试器」→「Console」，
VSCode的 Debug Console 不显示小程序日志
Prettier 格式化把 bind:tap 弄成 bindtap 或删掉 model:value
Prettier 默认按 HTML 规范处理属性，但 wxml 里的 bind:xxx、data-xxx、model:value 都是非标准写法，一格式就错。
实操建议：
- 在
settings.json关掉 Prettier 对 wxml 的接管："[wxml]": {<br> "editor.defaultFormatter": null<br>} - 或者用
.prettierrc单独禁用：{<br> "overrides": [<br> { "files": "*.wxml", "options": { "htmlWhitespaceSensitivity": "ignore" } }<br> ]<br>} - 别用
editor.formatOnSave全局开，改成按语言粒度控制，比如只对javascript和typescript开启 - WXML 格式化交给
minapp自带逻辑，它认微信语法，不会乱动自定义属性
真正卡住人的从来不是“怎么配”，而是搞不清 VSCode 和微信开发者工具的分工边界。比如以为装了某个插件就能“一键启动小程序”，结果终端报 command not found；又或者在 VSCode 里打完断点，却盯着自己的 Debug Console 等日志——这些都不是配置问题，是职责混淆。把 VSCode 当编辑器用，把微信开发者工具当运行时用，边界划清了，剩下的就是填几个 JSON 字段的事。
