webstorm不支持真机调试，仅负责代码编辑与构建；真机调试全程由微信开发者工具控制，需确保project.config.json路径正确、构建产物完整、sourcemap匹配且网络配置无误。
WebStorm 本身不参与真机调试连接
WebStorm 无法建立或管理微信小程序的真机调试连接——它没有实现 weapp-debugger 协议，也不具备与手机微信客户端通信的能力。真机调试的整个链路（二维码生成、设备发现、WebSocket 连接、源码注入、断点同步）完全由微信开发者工具控制。WebStorm 只负责编辑代码、生成构建产物（如 miniprogram/ 目录），而这些文件必须被微信开发者工具正确加载，才可能在真机上运行和调试。
确保 WebStorm 输出的代码能被真机调试识别
真机调试失败常源于源码路径错乱或构建产物未更新，WebStorm 需配合以下配置保证输出可用：
微信公众平台开发入门教程 中文WORD版
下载
由于微信的大热，为了更好的方便使用微信的用户查询一些信息，这篇文章是入门级的微信公众平台开发教程，需要的朋友可以参考下 这篇入门教程将引导你完成如下任务： 创建百度云平台应用启用微信公众平台开发模式获取订阅、文字、图片、语音、视频消息回复文本、图文及音乐消息程序开发
- 项目根目录下必须存在合法的
project.config.json，且其中miniprogramRoot指向源码目录（如"miniprogramRoot": "miniprogram/"），不能指向构建后目录（如dist/或unpackage/） - 若使用 Taro / uni-app，确保
npm run build:weapp或类似命令已执行，并生成了完整、无报错的miniprogram/内容；WebStorm 中保存文件后，需确认微信开发者工具右上角“编译”按钮旁显示「已编译」而非「编译中…」 - 禁用 WebStorm 的
WeChat MiniProgram Support插件（该插件已多年未维护），改用官方WXML插件 +@types/wechat-miniprogram类型定义，避免因类型错误导致构建失败或 source map 偏移 - 检查
tsconfig.json（如用 TS）是否启用"sourceMap": true，且"outDir"与构建工具实际输出路径一致，否则真机调试时断点会跳到错误行
真机调试连接前，必须在微信开发者工具中完成三件事
WebStorm 不提供任何真机调试入口按钮，所有操作都在微信开发者工具中进行，但 WebStorm 的配置会影响这三步能否成功：
- 点击工具栏「真机调试」按钮 → 扫描二维码前，确认左下角显示「真机调试2.0」（推荐）；若未显示，点击「切换真机调试2.0」并重启工具
- 确保手机与电脑处于同一局域网，且微信开发者工具「详情 → 本地设置」中勾选「不校验合法域名」——否则真机访问本地后端（如
http://192.168.x.x:3000/api）会直接失败 - 在微信开发者工具中打开项目后，点击右上角「编译」旁的下拉箭头 → 选择「真机调试」而非「模拟器」；此时工具会自动打包并等待扫码，而非启动本地模拟器
真机上看不到页面？先查 WebStorm 里这几个地方
真机扫码后白屏、卡在 loading、或控制台报 Cannot find module，问题大概率出在 WebStorm 管理的源码结构上：
- 检查
app.js是否在miniprogram/下，且未被 WebStorm 标为Excluded（右键目录 → Mark Directory as → 取消 Excluded） - 确认
pages/下每个页面的.js和.json文件都存在，且app.json中pages数组路径与磁盘实际路径严格一致（区分大小写、斜杠方向） - 若用了 npm 构建（如
miniprogram_npm/），WebStorm 中需将该目录设为Excluded，否则可能干扰索引，导致 import 路径解析失败 - 真机调试时，
console.log输出会出现在微信开发者工具「调试器 → Console」中，但上下文默认是VM Context 1；若看不到日志，手动切换右上角环境选择器到该上下文
