微信开发者工具必须安装，VS Code 仅作代码编辑辅助；其无法运行或调试小程序，所有构建、模拟器、调试均依赖官方工具。
微信开发者工具必须装，VS Code 只是辅助编辑器
VS Code 本身不能运行或调试微信小程序，它不提供 app-service 环境、WXML 编译器或真机预览能力。所有构建、模拟器启动、接口调试都依赖官方 微信开发者工具。VS Code 的角色是写代码更顺手——比如更好的 TypeScript 支持、Git 集成、快捷键自定义。
常见错误现象：点击 VS Code 里的“运行”按钮没反应、WXS 文件报错但微信开发者工具里能跑、console.log 出现在 VS Code 终端而非小程序调试器中。这些都不是配置问题，而是职责混淆。
- 安装最新版
微信开发者工具（注意选「稳定版」，Beta 版对miniprogram-ci兼容性差） - 在微信开发者工具设置里开启「服务端口」：勾选
启用 HTTP 服务，端口默认56789（后续自动化会用到） - VS Code 中无需安装“微信小程序开发插件”这类名字夸张的扩展——它们大多只提供语法高亮或片段，不解决核心链路
让 VS Code 正确识别 .wxml、.wxss、.wxs
默认情况下 VS Code 把 .wxml 当作纯 XML，没有标签闭合校验、属性提示和 WXS 脚本跳转支持。需要手动关联语言模式。
操作路径：Ctrl + Shift + P → 输入 Change Language Mode → 回车 → 选择 WXML（如果没看到，先装官方扩展 minapp，作者是 qiu8310，不是广告，它至今仍是唯一稳定维护 WXML 语言服务的扩展）
-
.wxml：装minapp后自动识别；若仍不生效，在settings.json加："files.associations": {"*.wxml": "wxml"} -
.wxss：VS Code 内置 CSS 支持已足够，但建议加"files.associations": {"*.wxss": "css"}避免误判为 plain text -
.wxs：本质是 JavaScript 子集，但微信限制了 API。用"files.associations": {"*.wxs": "javascript"}，再配合 ESLint 规则禁用不支持的全局变量（如console、setTimeout）
调试时断点不命中？检查 sourceMap 和编译输出路径
微信开发者工具生成的 miniprogram_npm/ 或 miniprogram_dist/ 是实际运行代码，而你写的源码在 src/ 或根目录。如果没配好 source map，VS Code 里打的断点根本不会触发。
关键点不在 VS Code，而在项目构建配置。以 miniprogram-build 或 npm run build 类脚本为例：
- 确保构建命令中开启了
sourceMap: true（例如webpack.config.js里有devtool: 'source-map'） - 输出目录（如
dist/）必须与微信开发者工具项目根目录一致；否则工具读不到dist/app.js.map - 微信开发者工具 > 详情 > 本地设置 > 勾选
启用代码压缩上传会破坏 sourceMap，调试阶段务必关闭
验证方法：在微信开发者工具「调试器」→「Sources」里，能看到带 webpack:// 或 src/ 前缀的原始文件路径，才说明映射成功。
想用命令行构建或 CI？绕过微信开发者工具图形界面
CI 流程里不能弹出 GUI，必须用 miniprogram-ci。但它不处理源码编译，只负责上传、预览、提审。也就是说：你得自己先把 src/ 编译成符合微信要求的结构（含 project.config.json、app.js、app.json 等），再交给 miniprogram-ci。
- 不要直接
npx miniprogram-ci upload原始源码目录——大概率报错Cannot find app.json - 先执行你的构建脚本（如
npm run build），输出到dist/，且确保dist/project.config.json存在、appid字段正确 -
miniprogram-ci的upload方法参数里，projectPath必须指向这个dist/目录，不是源码目录 - 私钥权限容易被忽略：
privateKeyPath对应的文件需是.pkcs8格式，且不能有密码；微信后台下载的是.pem，要用openssl pkcs8 -in key.pem -out key.pkcs8 -nocrypt转换
最常卡住的地方不是命令写错，而是构建产物没清理干净、project.config.json 里 miniprogramRoot 指向了错误路径、或者 CI 机器没装 Node.js 16+（miniprogram-ci@2.x 强制要求）。
