問題背景

在微信小程序開發(fā)中，啟動項目時可能會遇到如下報錯：
[ app.json 文件內(nèi)容錯誤] app.json: app.json 未找到 (env: Windows, mp, 1.05.2204250; lib: 3.7.7)

該錯誤的根本原因是核心文件未正確放置在項目根目錄。本文將詳細解釋問題原因并提供解決方案。

核心文件與目錄結(jié)構(gòu)規(guī)范

微信小程序強制要求以下三個文件必須直接存放在項目根目錄下：

• app.js - 小程序邏輯入口
• app.json - 小程序全局配置（頁面注冊、窗口樣式等）
• app.wxss - 小程序全局樣式表

正確的目錄結(jié)構(gòu)示例

項目根目錄/
├── 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 內(nèi)容格式錯誤（如缺少逗號、引號不匹配）

解決方法

1. 檢查核心文件位置

• 確保 app.js、app.json、app.wxss 直接位于項目根目錄。
• 如果誤將文件放入子文件夾，需剪切到根目錄。

2. 核對文件名

• 檢查文件名是否全小寫且無拼寫錯誤：
  • app.js（正確） vs App.js（錯誤）
  • app.json（正確） vs app.jsonn（錯誤）

3. 校驗 app.json 格式

• 使用 JSON Validator 檢查內(nèi)容格式是否正確：

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

// 錯誤示例（缺少逗號）
{
  "pages": ["pages/index/index"]
  "window": {
    "navigationBarTitleText": "Demo"
  }
}

4. 重啟開發(fā)者工具

修改后，關(guān)閉并重新打開微信開發(fā)者工具以確保變更生效。

其他注意事項

• project.config.json：此文件可配置項目設(shè)置，但不會影響核心文件路徑規(guī)則。
• 自定義目錄：頁面（pages）、組件等可放在子目錄，但三個核心文件必須保留在根目錄。
• 版本兼容：檢查開發(fā)者工具是否為最新版本（舊版本可能存在路徑解析問題）。

總結(jié)

app.json未找到 錯誤通常由核心文件路徑錯誤或配置問題引發(fā)。請始終遵循以下原則：

• 核心文件必須在根目錄
• 嚴格檢查文件名和格式
• 善用開發(fā)者工具的代碼校驗功能

通過規(guī)范目錄結(jié)構(gòu)和仔細排查文件配置，可快速解決此類問題。遇到類似錯誤時，建議優(yōu)先檢查根目錄文件完整性。

到此這篇關(guān)于微信小程序開發(fā)報:“app.json未找到”錯誤的原因與解決方法的文章就介紹到這了,更多相關(guān)微信小程序app.json未找到錯誤內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論