项目配置

本文说明如何通过配置文件将小程序适配为你的品牌与接口地址，并与 Halo 后台对齐。

配置文件一览

文件作用
src/config/app.config.json基础配置**
src/pages.jsonuni-app 页面路由、TabBar、分包、预加载等
src/manifest.json应用名称、版本号、各端 AppID 等

[!IMPORTANT] 配置在构建时被打包进产物，修改配置后需重新执行 pnpm dev:* 或 pnpm build:* 才能生效。

app.config.json — 基础配置

该配置文件为小程序基础配置，

最小可运行示例

在 src/config/app.config.json 中填写以下内容即可启动（请替换为你的实际域名与文案）：

{
  "app": {
    "name": "困困鱼",
    "logo": "/static/xingdu-logo.svg",
    "description": ""
  },
  "halo": {
    "baseURL": "https://your-halo.example.com"
  }
}

配置项详解

app — 应用基本信息

字段说明
name名称，展示于我的页面
logoLogo 地址，可为本地路径（/static/...）或完整 URL

[!TIP] 当你的品牌 Logo 比较扁、比较高，或左右留白较多时，优先通过 app.logoWidth 调整显示宽度；如果应用名称过长或品牌字重较强，可通过 app.nameFontSize 微调标题大小，而不必改代码。

halo — Halo 服务连接

字段说明
baseURLHalo 服务根地址，在生产环境中，需与小程序 request 合法域名一致（HTTPS）
timeout请求超时时间（毫秒），默认 10000

pages.json — 页面路由与导航配置

当你需要新增页面、调整首页、修改底部导航、拆分分包，或控制页面标题与下拉刷新时，可以修改当前内容。

[!warning]

如非开发需求，通常不太建议修改 pages.json。

常见修改项

此处仅列出一些常见的配置项，详细配置请参阅 https://uniapp.dcloud.net.cn/collocation/pages

场景常改位置说明
修改导航栏tabBar.list 和 pages导航栏数据
新增页面pages / subPackages[].pages页面文件创建后，必须在这里注册
修改页面标题style.navigationBarTitleText控制原生导航栏标题文字
拆分分包subPackages将低频页面拆到分包，减少主包体积
配置预加载preloadRule预加载某些分包，优化进入后续页面速度

manifest.json — 应用信息与平台配置

当你需要填写小程序 AppID、修改应用名称、更新版本号、声明平台权限，或调整特定平台能力时，可修改此配置文件。

[!warning]

通常只需要修改一些小程序信息相关的基础配置项，权限配置等已默认配置完成。

常见修改项

字段说明
name应用名称
description应用描述
versionName版本名称，例如 1.0.0
versionCode版本号，通常为递增数字

微信小程序配置

字段说明
mp-weixin.appid微信小程序 AppID，发布前必须替换为你自己的
mp-weixin.setting.urlCheck开发阶段可用于关闭合法域名校验，正式发布前应按平台要求检查

[!IMPORTANT] mp-weixin.appid 需与微信公众平台中的小程序主体保持一致，否则真机预览、上传、发布流程会受影响。

有关 manifest.json 的详细配置文件，请参阅 manifest.json 应用配置。