vscode本身不运行、不编译、不调试微信小程序，仅作编辑器；所有预览、真机调试、性能分析必须用微信开发者工具完成，配置核心是打通vscode编辑与开发者工具编译调试的协作流程。
VSCode 本身不支持直接运行微信小程序
微信小程序的运行和调试必须依赖微信开发者工具，VSCode 只能作为代码编辑器。强行在 VSCode 中“运行”小程序，只会得到 Cannot find module 'miniprogram-simulate' 或空白页面——因为缺少小程序运行时环境、 WXML/WXSS 编译器、以及真机/模拟器调试桥接能力。
正确路径是：VSCode 编辑 → 微信开发者工具编译 + 预览 + 调试。关键在于打通两者协作流程，而不是让 VSCode 替代开发者工具。
配置自动编译 + 热重载（需微信开发者工具开启服务端口）
微信开发者工具提供了一个 HTTP 服务接口（默认 http://127.0.0.1:51906），VSCode 可通过插件触发项目编译，实现保存即刷新的效果。
- 在微信开发者工具中打开「设置」→「安全」→ 勾选
服务端口（端口号可自定义，默认 51906） - VSCode 安装插件：
Minapp（推荐）或wechat-miniprogram-snippets（仅补全） -
Minapp插件启用后，按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Minapp: Compile Project即可触发编译 - 若想保存自动编译，可在 VSCode 设置中添加：
"minapp.autoCompile": true（注意：频繁保存可能触发微信开发者工具卡顿，建议仅对.js/.wxml文件生效）
在 VSCode 中断点调试（需配合微信开发者工具 Sources 面板）
VSCode 无法直接 attach 小程序渲染层或逻辑层进程，但可通过 sourcemap 映射实现“伪调试”：在 VSCode 打断点 → 微信开发者工具自动跳转对应位置 → 实际断点仍由开发者工具控制。
- 确保项目
project.config.json中"miniprogramRoot"正确指向源码目录（如"miniprogram/"） - 微信开发者工具「详情」→「本地设置」→ 开启
启用代码压缩混淆的反选（即关闭混淆），否则 sourcemap 失效 - 编译后，在微信开发者工具的
Sources面板中能看到 VSCode 中的原始路径（如miniprogram/pages/index/index.js），点击即可打断点 - VSCode 中的断点不会生效，但修改代码保存后，微信开发者工具会自动刷新并保持断点位置（前提是 sourcemap 生成正常）
常见报错与绕过方案
遇到 Failed to load script: https://lib/WASDK.js 或 WAServiceMain is not defined，基本是环境链路断裂：
- 微信开发者工具未登录或未选择「小程序」项目类型 → 重新新建项目，模板选
小程序，不要选「云开发」或「插件」模板后再改 - VSCode 工作区根目录不是
project.config.json所在目录 → 必须用该文件所在文件夹打开整个工作区 - 微信开发者工具版本过旧（
- 使用了
npm构建的第三方包（如lodash）但未执行构建 npm→ 在微信开发者工具菜单栏点击「工具」→「构建 npm」，且勾选「使用 npm 模块」
微信小程序的调试闭环始终绕不开开发者工具，VSCode 的价值在于编辑效率和工程集成，别试图让它承担运行时职责。
