vscode打开.wxml文件无高亮补全是因默认不识别该后缀，需安装minapp扩展并配置files.associations；调试需启用微信开发者工具远程调试；ts需安装miniprogram-api-typings并为page加泛型；编译更新依赖开发者工具自动编译。

VSCode 打开 .wxml 文件全是纯文本，没标签高亮和补全

这不是文件坏了，是 VSCode 默认不认识 .wxml 后缀。它不会自动当成 HTML 解析，所以没有闭合提示、属性联想、格式化支持。

实操建议：

• 必须安装 minapp 扩展（作者：qiu8310），它是目前唯一稳定维护、支持 WXML/WXSS 语义的官方推荐插件
• 在项目根目录创建 .vscode/settings.json，写入：

  {"files.associations": {"*.wxml": "html", "*.wxss": "css"}}

  ，否则 minapp 的补全功能无法触发
• 别装「vscode-wxml」或「wechat-snippet」这类老插件——它们不维护了，和微信基础库 3.x+ 冲突，补全内容错漏多

断点打上了，但调试时完全不生效

VSCode 本身不运行小程序 JS，所有逻辑都在微信开发者工具里执行。你点「开始调试」却没连上调试通道，本质是调试协议没通。

实操建议：

• 微信开发者工具 → 右上角「调试器」→ 「调试」→ 勾选「启用远程调试」，端口默认 9229，不要改
• 删掉手动写的 launch.json 里 type 为 node 的配置——那是给 Node.js 用的，对小程序无效
• 用 minapp 扩展自带的「Launch MiniProgram」启动配置，它会自动唤起开发者工具并注入 WebSocket 调试协议
• console.log 输出只出现在微信开发者工具的「Console」面板，VSCode 的 Debug Console 不显示任何小程序日志

TS 中 Page({ onLoad(options) { } }) 的 options 类型是 any

微信原生 TS 支持靠 miniprogram-api-typings，但它只覆盖 API 返回值，不描述页面生命周期参数结构。你不显式声明，TS 就没法校验 options.id 是否存在。

Wechat MP Article Stats Comments Suite - 微信公众号管理套件

公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。

下载

实操建议：

• 执行：npm install --save-dev miniprogram-api-typings，别用 @types/wechat-miniprogram——它版本滞后，常导致 getOpenUserInfo 等新 API 报错
• 在 tsconfig.json 的 types 字段加入 "miniprogram-api-typings"
• 给 Page 加泛型：

  Page({ onLoad(options) { console.log(options.id) } })

  ，否则类型推导就是摆设

保存后代码没更新，还得切回开发者工具点「重新编译」

VSCode 是编辑器，不是构建工具。它不监听文件变化、不触发编译、不刷新模拟器。所谓「热更新」必须由微信开发者工具自己完成。

实操建议：

• 确保微信开发者工具开启了「自动编译」（设置 → 编译设置 → 勾选「保存代码后自动编译」）
• 别依赖 VSCode 插件做「保存即编译」——目前没有稳定可靠的插件能接管微信的构建流程
• 如果用了 UniApp 或 Taro，那编译行为由对应 CLI 控制，VSCode 仅负责编辑源码，dist 目录需由 CLI 输出，开发者工具打开的是输出目录，不是源码目录

最易被忽略的一点：project.config.json 里含本地绝对路径和调试端口，直接拿它开项目，VSCode 会报 schema 校验失败。删掉 debugOptions 和 condition 字段再用。