VSCode无法直接配置微信小程序模拟器，所有模拟和调试均由微信开发者工具完成；Minapp插件仅提供语法支持，需手动配置settings.json、正确设置cli路径、启用远程调试，并确保VSCode与微信开发者工具打开同一项目根目录。
VSCode 本身没有、也不能配置微信小程序模拟器——它不提供任何运行时环境，所有“模拟”都由微信开发者工具完成；所谓“调试”，本质是 VSCode 编辑器通过 CLI 和调试协议，与微信开发者工具联动。
minapp 插件必须装，但只起编辑辅助作用
官方推荐插件 Minapp（作者 qiu8310）是目前最稳定的支持入口，它提供 .wxml/.wxss 语法高亮、app.json schema 校验、WXML 标签自动闭合等基础能力。但它不启动模拟器、不编译代码、不注入调试器。
- 安装后必须手动在项目根目录创建
.vscode/settings.json，写入：{"files.associations": {"*.wxml":"html","*.wxss":"css"}}，否则 WXML 会被当纯文本处理 - 别信“一键启动模拟器”宣传——插件里所有“Launch MiniProgram”类命令，底层都是调用
cli.bat（Windows）或cli（macOS），最终唤起的是微信开发者工具 - 如果插件没反应，先检查是否已配置
minapp-ide-cli-path：路径必须精确到可执行文件，不能是目录，且不能含中文、空格或特殊符号
调试断点只在微信开发者工具里生效
你在 VSCode 的 onLoad 行号上打的断点，不会让 VSCode 停住；它需要微信开发者工具开启远程调试端口，并把源码映射关系传给 VSCode。
- 微信开发者工具需打开「调试器」→「调试」→ 勾选「启用远程调试」（默认端口
9229） - VSCode 的
launch.json不要手写type: "node"配置——应直接使用Minapp提供的预设配置Launch MiniProgram - 首次调试前，务必先在微信开发者工具里手动点一次「编译」，否则 VSCode 启动调试会静默失败，无错误提示
-
console.log输出永远只出现在微信开发者工具右上角「调试器」→「Console」面板，VSCode 的 Debug Console 不显示小程序日志
WXML/WXSS 格式化容易冲突，必须锁死主力插件
多个格式化插件同时注册 .wxml 或 .wxss 处理权，会导致保存时结构错乱、标签被强行闭合、甚至报错 Failed to format document。
- 只保留两个插件：
wechat-snippet（专注 WXML 结构补全） +Easy WXLESS（专注 WXSS 格式化） - 在 VSCode 设置中搜索
default formatter，为wxml文件类型指定wechat-snippet，为wxss指定Easy WXLESS - 若项目已启用 Prettier，必须在根目录加
.prettierrc并显式排除：{"ignore": ["**/*.wxml", "**/*.wxss"]}，否则它会按 JS 规则破坏 WXML 标签嵌套
project.config.json 是协作关键，但必须清理冗余字段
这个文件不是给 VSCode 看的，而是微信开发者工具识别项目结构的唯一依据；VSCode 打开项目后一切报错（如 app.json not found），大概率是它没对齐或含无效字段。
- 确保
miniprogramRoot字段值为"./"或相对子路径（如"./src/"），不能是绝对路径 - 删掉
debugOptions和condition字段——它们是微信开发者工具本地调试快照，VSCode 无法解析，还会触发校验失败 - VSCode 和微信开发者工具必须打开**完全相同的项目根目录**，路径差一级都会导致文件监听失效、热重载不触发
真正容易被忽略的，是“保存”这件事本身：微信开发者工具默认只读取已落盘的文件，VSCode 里改了 index.wxml 但没按 Ctrl+S，切换过去点编译，看到的还是旧内容——这不是配置问题，是协作节奏没对齐。
