问题：**为何运行项目时提示“未找到 app.json”？**

Question

在运行 React Native 或 Expo 项目时，若控制台提示“未找到 app.json”，通常是因为项目根目录缺少该配置文件。`app.json` 是 Expo 和 React Native 项目的重要配置文件，用于定义应用名称、入口文件、权限、SDK 版本等信息。常见原因包括：项目初始化不完整、文件被误删或未正确创建；使用 Expo CLI 时未执行 `expo init`；或从 Git 仓库克隆后遗漏了该文件。解决方法包括检查项目结构、手动创建 `app.json` 或运行 `expo init` 重新生成配置文件。确保该文件位于项目根目录，并格式正确，是避免该问题的关键。

Answer 1

一、问题现象：运行 React Native 或 Expo 项目时提示“未找到 app.json”

在使用 React Native 或 Expo 开发移动应用时，开发者可能会遇到如下错误信息：

Error: Cannot find module 'app.json'

该提示表明项目根目录下缺少 app.json 文件，而该文件是 Expo 和 React Native 项目的核心配置文件。

1.1 什么是 app.json？

app.json 是一个 JSON 格式的配置文件，通常位于项目根目录，用于定义应用的基本信息和配置参数。包括但不限于：

• 应用名称（name）
• 入口文件路径（main）
• 应用图标、启动画面（icon、splash）
• 权限声明（permissions）
• Expo SDK 版本（sdkVersion）
• 平台特定配置（ios、android）

1.2 常见错误原因

出现“未找到 app.json”的问题，通常是以下几种原因之一：

原因	说明
项目初始化不完整	使用 expo init 或 react-native init 初始化项目时中断或失败
文件被误删或未正确创建	开发过程中误操作删除了该文件，或手动创建时格式错误
未执行 expo init	使用 Expo CLI 时未执行初始化命令，导致缺少默认配置文件
从 Git 仓库克隆后遗漏	.gitignore 中可能忽略了 app.json，导致克隆后文件缺失

二、问题分析与排查流程

为了准确诊断和解决该问题，建议按照以下流程进行排查：

graph TD
    A[启动项目] --> B{是否存在 app.json?}
    B -- 是 --> C[检查文件格式是否正确]
    B -- 否 --> D[确认项目是否初始化完整]
    D --> E{是否使用 Expo CLI?}
    E -- 是 --> F[运行 expo init 生成配置文件]
    E -- 否 --> G[手动创建 app.json 文件]
    C --> H[运行项目]
    F --> H
    G --> H

2.1 检查项目结构

首先确认项目的根目录中是否存在 app.json 文件。可以通过以下命令查看：

ls -la

如果未看到该文件，则需要手动创建或重新初始化项目。

2.2 手动创建 app.json 示例

可以手动创建一个基本的 app.json 文件，内容如下：

{
  "name": "MyApp",
  "slug": "my-app",
  "version": "1.0.0",
  "sdkVersion": "44.0.0",
  "platforms": ["ios", "android"],
  "main": "index.js",
  "icon": "./assets/icon.png",
  "splash": {
    "image": "./assets/splash.png"
  }
}
  

确保 JSON 格式正确，无语法错误。

2.3 使用 Expo CLI 初始化项目

如果项目尚未初始化，可以运行以下命令重新生成：

expo init .

该命令会在当前目录下生成标准的项目结构和配置文件，包括 app.json。

三、进阶建议与最佳实践

为了减少类似问题的发生，建议开发者遵循以下最佳实践：

• 始终使用 expo init 或 npx react-native init 初始化项目
• 将 app.json 文件加入版本控制（Git），避免遗漏
• 使用 JSON 校验工具确保配置文件格式正确
• 在 CI/CD 流程中加入配置文件存在性检查
• 对于团队协作项目，制定统一的配置模板