微信小程序开发报:“app.json未找到”错误的原因与解决方法

问题背景

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

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

核心文件与目录结构规范

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

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

正确的目录结构示例

项目根目录/
├── app.js
├── app.json
├── app.wxss
├── pages/
│   └── index/
│       ├── index.js
│       ├── index.wxml
│       └── index.wxss
└── 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 检查内容格式是否正确：

// 正确示例
{
  "pages": ["pages/index/index"],
  "window": {
    "navigationBarTitleText": "Demo"
  }
}

// 错误示例（缺少逗号）
{
  "pages": ["pages/index/index"]
  "window": {
    "navigationBarTitleText": "Demo"
  }
}

4. 重启开发者工具

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

其他注意事项

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

总结

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

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

通过规范目录结构和仔细排查文件配置，可快速解决此类问题。遇到类似错误时，建议优先检查根目录文件完整性。

到此这篇关于微信小程序开发报:“app.json未找到”错误的原因与解决方法的文章就介绍到这了,更多相关微信小程序app.json未找到错误内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论