---
title: project.config.json
summary: 介绍小程序项目配置文件 project.config.json 的作用及主要配置项（devMode、remoteDebug、compileType）。
questions:
  - project.config.json 是什么？
  - devMode 有哪些可选值？
  - ray 模式是什么？
  - remoteDebug 的 mqtt 和 lan 模式有什么区别？
  - compileType 支持哪些类型？
  - 如何开启 ray 自动编译模式？
  - 如何配置 npm 编译模式？
  - 调试模式 mqtt 和 lan 分别适用于什么场景？
---

## 项目配置文件 `project.config.json`

`project.config.json` 文件是小程序项目的配置文件，用于配置项目的基本信息、构建配置、开发者工具配置等。

- devMode: 是否开启 ray 自动编译模式
  - `ray`: 开启 ray 自动编译模式,
  - `npm`: 实际上就是执行 npm run start（package.json 里的 script）
  - 空字符串或者不配置: 需要自己手动编译
- remoteDebug: 调试模式
  - `mqtt`: 使用远程模式，只需要在有网络的情况下即可
  - `lan`: 使用局域网模式，需要在开发者工具和 app 在同个网络下
- compileType: 编译类型
  - `miniprogram`: 小程序
  - `widget`: 小程序卡片