VSCode仅作代码编辑器，不能运行或调试微信小程序；必须安装持续维护的minapp扩展并配置文件关联，搭配miniprogram-api-typings类型定义，且微信开发者工具需开启服务端口与远程调试。
VSCode 本身不选框架，它只负责写代码；真正决定用什么框架的，是你项目初始化时执行的命令和依赖的构建工具。
你看到的“微信小程序开发插件”“WeApp API 支持”之类扩展，基本都已停更或与当前基础库（3.x+）不兼容。硬装反而会破坏 minapp 的 WXML 补全和类型解析。
minapp 扩展是唯一必须装的
它不是“可选项”，而是目前（2026 年 5 月）仍在持续维护、能真正支撑 WXML 标签补全、app.json schema 校验、页面跳转（Ctrl+Click）、生命周期函数提示的唯一扩展。
- 安装后，
.wxml文件才能识别view、button等标签，并提示属性（如bindtap、data-） - 若没装，VS Code 默认把
.wxml当纯 XML，连闭合校验都没有 - 别装名字含“微信小程序开发助手”“WeChat Mini Program”的插件——它们大多 2023 年后就没更新，会和
minapp冲突，导致补全失效
装完后，在 .vscode/settings.json 中加这一行确保语言模式生效：
{
"files.associations": {
"*.wxml": "wxml",
"*.wxss": "css",
"*.wxs": "javascript"
}
}
miniprogram-api-typings 替代 @types/wechat-miniprogram
社区版 @types/wechat-miniprogram 已严重滞后，常见 getOpenUserInfo、openLocation 等 API 类型缺失或签名错误。
- 正确做法：运行
npm install --save-dev miniprogram-api-typings - 在
tsconfig.json中显式指定类型根路径：{ "compilerOptions": { "typeRoots": ["./types", "./node_modules/@types"] } } - 把
node_modules/miniprogram-api-typings/index.d.ts软链或复制到项目types/目录下（否则 VS Code 可能找不到）
Page 的 onLoad 参数默认是 any，必须加泛型才准：Page<{id: string}>(...)
断点不命中？问题不在 launch.json
VS Code 的调试器无法直接 attach 微信开发者工具的 app-service 进程。所谓“断点调试”，实际靠的是 source map + 微信工具内置的 DevTools 协议。
- 不要手动配
launch.json的type: "node"或"chrome"—— 它们对小程序无效 - 真正起作用的是：微信开发者工具开启「调试器」→「调试」→ 勾选「启用远程调试」（端口默认 9229），再配合
minapp扩展的「Launch MiniProgram」任务 - 更关键的是构建环节：确保
tsc或webpack输出了正确的.js.map，且outDir和微信工具的miniprogramRoot完全一致
混写 .ts 和 .js 在同一目录（如 miniprogram/）是高频翻车点：微信工具可能加载旧的 .js，你改了 .ts 却完全没反应。
框架选择其实发生在项目创建阶段，不是 VS Code 配置阶段
- 原生开发：用微信开发者工具新建项目 → 用 VS Code 打开，只配
minapp+miniprogram-api-typings - Taro：运行
npx @tarojs/cli init myapp→ VS Code 打开，装Taro Tools插件，不用minapp - UniApp：用
vue create -p dcloudio/uni-preset-vue初始化 → 装uni-create-view和uni-helper，禁用minapp（二者冲突）
所有“一键生成骨架”“自动配置调试”的宣传，本质都是调用 CLI 在终端执行命令。VS Code 只是打开终端的窗口，不是魔法盒子。
最常被忽略的一点：微信开发者工具必须开「服务端口」（设置 → 安全 → 启用 HTTP 服务），否则自动化构建、CI 工具（如 miniprogram-ci）根本连不上。这个开关不在 VS Code 里，但在你每天第一次启动工具时就该确认。
