VSCode无法运行微信小程序代码，因其仅为编辑器而非运行时环境，必须配合微信开发者工具使用；所有编译、预览、调试均依赖后者监听文件变化并执行。
VSCode 不能运行微信小程序代码，它连“运行”这个动作都不支持——所有编译、预览、调试都必须走微信开发者工具。 这不是配置不到位的问题，而是角色根本不同：VSCode 是编辑器，微信开发者工具才是运行时环境。
为什么在 VSCode 里点“运行”或执行 npm run dev 没反应
原生微信小程序项目没有内置启动命令。你看到的 npm run dev 通常来自 Taro、uni-app 等框架，不是微信官方原生支持的流程。
- 原生小程序的
package.json里一般只有eslint、stylelint这类开发依赖，npm install不会生成任何可执行服务 - VSCode 自带的终端执行
node app.js或npm start会直接报错command not found或空白页面，因为缺少 WXML 编译器、基础库注入、沙箱环境 - 所谓“微信小程序调试插件”的“Launch in WeChat DevTools”功能早已失效，官方未开放远程唤起 + 调试协议
VSCode 必须配对微信开发者工具才能工作
协作链路只有一条：你在 VSCode 编辑保存 → 微信开发者工具监听磁盘文件变化 → 自动编译 → 在模拟器/真机中执行。
- 项目根目录必须完全一致：VSCode 打开的文件夹路径 = 微信开发者工具「导入项目」时选中的含
project.config.json的目录 -
project.config.json中的miniprogramRoot字段要指向实际源码路径（如"./"或"./src/"），否则工具找不到app.js - 务必手动保存（
Ctrl+S/Cmd+S）：微信开发者工具默认不读取未保存的缓冲区内容 - 禁用 VSCode 的 Live Server 插件对小程序目录生效——它会起 HTTP 服务，但小程序不是静态网站，访问直接 404
断点不命中、console.log 看不到输出？检查这三个地方
这些现象不是 VSCode 配置错，而是调试通道没接通或映射失败。
- 微信开发者工具右上角「调试器」→「调试」面板中，必须勾选「启用远程调试」（默认端口
9229），否则 VSCode 无法注入调试协议 - TS 项目需确认：
tsconfig.json中"sourceMap": true，且微信开发者工具设置里开启「启用调试基础库 sourcemap」（该选项默认关闭） -
console.log输出永远不出现在 VSCode 的 Debug Console 里，必须打开微信开发者工具的「调试器」→「Console」面板；真机调试时还要摇一摇 → 「打开调试」→ 切到「vConsole」
WXML/WXSS 没高亮、标签不补全？别跳过文件关联
VSCode 默认把 .wxml 当纯文本，这不是插件没装，是语言模式根本没对上。
- 按
Ctrl+Shift+P→ 输入Change Language Mode→ 回车 → 选择WXML（若无此选项，先装minapp扩展） - 在
.vscode/settings.json中强制关联："files.associations": {"*.wxml": "wxml", "*.wxss": "css"} - 别用 Prettier 格式化
.wxml：它会删掉bindtap、data-xxx等非标属性，导致编译报错；可在settings.json中加"prettier.disableLanguages": ["wxml"]
最常被忽略的其实是 project.config.json 里的 debugOptions 和 condition 字段——它们含本地绝对路径和调试端口，一并提交到 Git 会导致别人拉代码后校验失败。删掉再用，比反复调配置省事得多。
