VSCode 无法调试微信小程序，所有调试功能（断点、console、WXML渲染、wx.login等）必须由微信开发者工具完成；VSCode仅作编辑与类型支持，需配合构建、路径对齐和sourceMap才能协同调试。
VSCode 本身不提供微信小程序调试能力，所谓“微信小程序插件”无法让你在 VSCode 里启动模拟器、设断点、看 WXML 渲染或调用 wx.login —— 这些必须由微信开发者工具完成。 安装任何名字带“微信小程序开发”的扩展，都只是补全、高亮、文件关联这类辅助功能，不是调试入口。
装了“minapp”扩展后 .wxml 还是没语法提示
常见错误现象：装完 minapp（作者 qiu8310）仍无标签闭合校验、属性补全、WXS 跳转；Ctrl+Click 点不进组件定义。
- 确认 VS Code 已重启（minapp 启动需完整加载语言服务）
- 手动触发语言模式切换：
Ctrl + Shift + P→ 输入Change Language Mode→ 回车 → 选WXML（若没出现，说明 minapp 未生效或被禁用） - 在项目根目录的
.vscode/settings.json中强制关联：{"files.associations": {"*.wxml": "wxml"}} - 避免装多个 WXML 插件（如 “WeApp MiniProgram”、“vscodewxml”），它们会冲突并覆盖 minapp 的语言服务
为什么装了插件，但 Page({}) 里 data 还标红、onLoad 参数是 any
这不是插件问题，是类型系统没对齐。VSCode 不知道 Page 是什么，也不认识 options 的结构。
微信公众号推文写作助手
下载
微信公众号推文写作与发布助手。支持深度文章撰写（1500+ 字）、智能配图搜索、API 配置引导、草稿箱上传、一键排版等全流程功能。 每篇文章默认 1500 字以上，配备 1 张相关配图（放在第一段后），包含清晰的分段标题结构。
- 必须安装类型声明包：
npm install --save-dev @types/wechat-miniprogram（注意：别用miniprogram-api-typings，它已停止维护且与基础库 3.x+ 不兼容） - 确保
tsconfig.json中包含："types": ["wechat-miniprogram"]
- 对页面加泛型才能推导
onLoad参数：Page<{ id: string }>({ onLoad(options) { console.log(options.id); } }) - 如果用了
uni-app，则应换用@uni-helper/uni-app-types，而非微信原生类型
装了插件，但保存 .ts 文件后微信开发者工具不刷新
这是最常被误认为“插件失效”的场景。本质是构建链路断裂：VSCode 编辑的是 .ts，微信工具运行的是 .js，中间缺编译这一步。
- 检查
project.config.json中的miniprogramRoot是否指向实际输出目录（如./dist/miniprogram），而不是源码目录（如./src） - 确认你有运行构建命令（如
npx tsc -w或npm run build:mp），且输出路径和微信工具读取路径一致 - 禁用微信开发者工具里的「ES6 转 ES5」和「增强编译」——这两项会干扰 sourceMap 映射，导致 VSCode 断点失效
- 不要在
miniprogram/目录下混写.ts和.js，否则微信工具可能加载旧的.js而忽略新编译结果
真正容易被忽略的点是：所有调试行为（console、断点、setData 变量监视、WXML 实时高亮）都发生在微信开发者工具进程内，VSCode 只负责把代码写对、存好、类型标清。路径对齐、sourceMap 开启、构建命令持续运行 —— 这三件事没做对，装再多插件也白搭。
