ToB企服应用市场:ToB评测及商务社交产业平台

标题: 微信小程序开发：解决“app.json未找到”错误的原因与解决方法 [打印本页]

---

作者: 我可以不吃啊    时间: 2025-2-19 08:43
标题: 微信小程序开发：解决“app.json未找到”错误的原因与解决方法
微信小程序开发：解决“app.json未找到”错误的原因与解决方法

问题背景

在微信小程序开发中，启动项目时可能会碰到如下报错：
[ app.json 文件内容错误] app.json: app.json 未找到 (env: Windows, mp, 1.05.2204250; lib: 3.7.7)

该错误的根本原因是核心文件未正确放置在项目根目次。本文将详细表明问题原因并提供解决方案。

---

核心文件与目次结构规范

微信小程序强制要求以下三个文件必须直接存放在项目根目次下：

• app.js - 小程序逻辑入口
  
• app.json - 小程序全局设置（页面注册、窗口样式等）
  
• app.wxss - 小程序全局样式表
  

✅ 正确的目次结构示例

1. 项目根目录/
2. ├── app.js
3. ├── app.json
4. ├── app.wxss
5. ├── pages/
6. │   └── index/
7. │       ├── index.js
8. │       ├── index.wxml
9. │       └── index.wxss
10. └── utils/

复制代码

❌ 常见错误场景

• 将 app.js/json/wxss 放在子目次中（如 /src 或 /config）如图
  
  
  
  
• 文件名拼写错误（如 App.json、app.JSON）
  
• app.json 内容格式错误（如缺少逗号、引号不匹配）
  

---

解决方法

1. 检查核心文件位置

• 确保 app.js、app.json、app.wxss 直接位于项目根目次。
  
• 如果误将文件放入子文件夹，需剪切到根目次。
  

2. 核对文件名

• 检查文件名是否全小写且无拼写错误：
  
  
  
  • app.js（正确） vs App.js（错误）
    
  • app.json（正确） vs app.jsonn（错误）
    
  
  

3. 校验 app.json 格式

• 使用 JSON Validator 检查内容格式是否正确：
  

1. // 正确示例
2. {
3.   "pages": ["pages/index/index"],
4.   "window": {
5.     "navigationBarTitleText": "Demo"
6.   }
7. }
9. // 错误示例（缺少逗号）
10. {
11.   "pages": ["pages/index/index"]
12.   "window": {
13.     "navigationBarTitleText": "Demo"
14.   }
15. }

复制代码

4. 重启开发者工具

修改后，关闭并重新打开微信开发者工具以确保变动生效。

---

其他留意事项

• project.config.json：此文件可设置项目设置，但不会影响核心文件路径规则。
  
• 自界说目次：页面（pages）、组件等可放在子目次，但三个核心文件必须保留在根目次。
  
• 版本兼容：检查开发者工具是否为最新版本（旧版本可能存在路径分析问题）。
  

---

总结

app.json未找到 错误通常由核心文件路径错误或设置问题引发。请始终遵循以下原则：

• 核心文件必须在根目次
  
• 严酷检查文件名和格式
  
• 善用开发者工具的代码校验功能
  

通过规范目次结构和仔细排查文件设置，可快速解决此类问题。碰到雷同错误时，建议优先检查根目次文件完备性。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)

Powered by Discuz! X3.4