郑州小程序开发：配置避坑指南

上周帮一位在郑州做社区生鲜的客户排查问题，小程序上线两周，首页加载要五六秒，用户吐槽“点开像在等电梯”。翻了下代码，业务逻辑没毛病，问题全出在配置上：图片没走 CDN、分包没拆、request 域名没配好导致请求走了代理。这类事在郑州本地项目里太常见了——大家把精力都放在写页面上，配置随手一填，最后全变成性能债。

这篇就聊聊小程序开发配置里那些真正影响体验的细节，也是我在知码客做郑州小程序开发和 APP 开发时反复踩过的坑。

一、app.json：先想清楚再动手

很多人拿到需求直接建页面，app.json 最后补。其实这个文件决定了小程序的结构骨架，改起来成本很高。

• pages 顺序：第一项就是启动页。有次客户要求“打开直接进商品列表”，结果首页配成了登录页，每次冷启动都多一次跳转。
• subpackages：主包超过 2MB 就传不上去。郑州这边做商城、做本地生活服务的项目，图片和富文本多，建议一开始就按“主包放首页和 tab 页、活动页和详情页进分包”来规划。
• window 配置：navigationBarTitleText 别写死成公司名，不同页面用各自的标题，分享出去才像回事。

二、域名与网络配置：最容易翻车的地方

开发阶段用 localhost 调接口很爽，上线前忘了配 request 合法域名，真机一跑全是红色报错。微信公众平台后台的“开发管理 - 开发设置”里要配三类域名：request 合法域名、uploadFile 合法域名、downloadFile 合法域名，而且必须是 HTTPS、已备案、不能带端口。

郑州客户经常问：“我们服务器在本地机房，没备案怎么办？”答案是没有捷径，域名备案是硬门槛。我一般建议先用云开发过渡，等备案下来再切回自建后端，这样前期联调不耽误进度。

// 统一封装请求，避免到处写死域名
const BASE_URL = 'https://api.example.com'

function request(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: BASE_URL + options.url,
      method: options.method || 'GET',
      data: options.data || {},
      timeout: 10000,
      success: res => {
        if (res.statusCode === 200) resolve(res.data)
        else reject(res)
      },
      fail: reject
    })
  })
}

另外记得在开发者工具里勾选“不校验合法域名”只用于本地调试，提交审核前一定要关掉，否则线上真机请求会直接失败。

三、分包与预下载：让首屏快起来

前面说的那个生鲜客户，主包塞了 1.8MB，其中一大半是商品详情页的富文本样式和图标。拆分包之后首屏从 5 秒降到 1.8 秒左右。配置上就两步：app.json 里声明 subpackages，页面跳转时用 wx.navigateTo 正常跳，微信会自动加载对应分包。

还可以配 preloadRule，在用户停留在首页时预下载高频分包：

"preloadRule": {
  "pages/index/index": {
    "network": "all",
    "packages": ["shop"]
  }
}

注意单个分包不能超过 2MB，总包不能超过 20MB，规划时留点余量。

四、本地场景里的配置细节

郑州的项目有个特点：不少客户同时要小程序和 APP，后端一套。这时候 app.json 里的 extAppid、以及多端框架的编译配置要提前对齐，不然小程序调通的接口，打包成 APP 后签名和域名白名单又得重来一遍。我在知码客接郑州做小程序的需求时，习惯在项目启动会上就把这份配置清单拉出来，跟客户确认清楚：用不用云开发、要不要接微信支付、地图用腾讯还是高德、客服消息走哪套。这些决定一旦定下来，配置文件基本就定型了。

配置不是写完就完事的活儿，它更像是给项目定规矩。规矩定得早，后面改需求才不慌。

五、上线前检查清单

1. app.json 里所有页面路径都存在，没有拼写错误
2. 合法域名三类都配齐，HTTPS 证书有效期确认
3. 主包体积、分包体积都在限制内
4. 隐私协议、用户信息授权弹窗按最新规范配置
5. 体验版真机跑一遍核心流程，别只信开发者工具

这些事看着琐碎，但每一条都对应着真实的线上事故。郑州本地做小程序开发的团队不少，配置这块拉开差距的往往不是技术多深，而是有没有把清单当回事。我是知码客，专注小程序和 APP 开发，用代码改变生活，下篇聊聊支付配置里的那些坑。