目录1. 核心原因目录打开错误最常见2. 次要原因AppID 配置问题3. 必要的检查服务端口是否开启总结操作流程心血来潮想开发一款属于自己的微信小程序一开始就出现以下运行报错如截图所示根据提供的截图和报错信息“AppID 失败” 和 “项目根目录未找到 app.json”这是 UniApp 开发中非常经典的新手问题。核心原因通常只有两个文件夹打开错了或者没有根据 manifest.json 配置正确的 AppID。请按照以下步骤逐一排查解决1. 核心原因目录打开错误最常见截图右侧报错Error: app.json: 在项目根目录未找到 app.json。原因UniApp 的源码.vue文件是不能直接被微信开发者工具识别的。通过 HBuilderX 运行后它会编译生成微信小程序代码。现在的微信开发者工具可能打开的是 UniApp 的项目根目录而不是编译后的目录。解决方案不要手动去微信开发者工具里点“打开项目”。正确的运行方式在HBuilderX中打开你的项目。点击顶部菜单栏的运行-运行到小程序模拟器-微信开发者工具。HBuilderX 会自动编译编译完成后会自动启动微信开发者工具并指向正确的目录。如果你非要手动打开请在微信开发者工具中将项目路径指向你的项目文件夹/unpackage/dist/dev/mp-weixin。注意一定要指向mp-weixin这一层因为app.json就在这里面。2. 次要原因AppID 配置问题截图中间的弹窗报错更改 AppID 失败 touristappid。原因你的项目配置文件manifest.json中可能没有填写 AppID或者填写的格式不对。微信工具试图用“游客模式touristappid”运行但因为某些权限或缓存问题失败了。解决方案回到HBuilderX。打开项目根目录下的manifest.json文件。点击左侧的“微信小程序配置”。在微信小程序 AppID一栏如果你有 AppID请填入你在微信公众平台注册的真实 AppID。如果你没有 AppID请去微信公众平台注册测试号或者先留空但留空有时会导致部分功能无法测试。保存文件重新点击“运行”编译一遍。3. 必要的检查服务端口是否开启为了让 HBuilderX 能顺利调用微信开发者工具你需要确保“服务端口”是开启的。操作步骤打开微信开发者工具。点击右上角的设置齿轮图标 -安全设置。确保“服务端口”这一项是开启打开状态。总结操作流程关闭当前的微信开发者工具。在 HBuilderX 里的manifest.json配置好 AppID。在 HBuilderX 点击“重新运行”。等待控制台显示“编译成功”并在工具中自动弹出页面。照做一般就能解决app.json not found的问题了。