Desenvolvedores tratam o teto de pacote do mini-programa — cerca de 2 MB para o pacote principal — como uma camisa de força. É a restrição mais útil que a plataforma te deu. Obriga as duas coisas que deixam um mini-programa rápido: um runtime compartilhado que você não envia, e um pacote pequeno que você de fato envia. O teto não é o limite do que você pode construir. É a razão pela qual sua primeira tela continua rápida.
O teto está fazendo um favor a você
Na web aberta um bundle pode inchar para 5, 10, 20 MB e ninguém te para. O resultado é uma geração de apps que levam sete segundos para ficar úteis. Um mini-programa que fisicamente não pode passar de 2 MB no pacote principal não esconde essa inchação. A restrição é uma revisão de código que você não precisou rodar.
E com um runtime próprio do host, o motor não está no seu pacote. Os 2 MB são seu código, seus ativos de negócio, sua lógica — não um framework JavaScript e um motor de render que você reenvia a cada abertura. Isso muda o que "2 MB" significa. É espaço para seu produto, não para sua tubulação.
O que realmente come o orçamento
- O framework em si. Se você empacota seu próprio runtime, gastou o teto antes de escrever uma funcionalidade. Deixe o host prover.
- Uma biblioteca de UI que você usa a 5%. Importar uma biblioteca de componentes por três botões é o imposto silencioso clássico. Importe os botões, não a biblioteca.
- Imagens no pacote. Sirva da CDN, não do bundle. Cada KB de imagem é um KB de atraso de início a frio.
- JSON grande na inicialização. Dados de fase, config, catálogos — busque em runtime, não empacote.
Disciplina vence esperteza
Os times que entregam mini-programas rápidos não são mais inteligentes. Estão limitados. Dividem o código por rota, carregam preguiçosamente o que não está na primeira tela, e tratam o pacote como bagagem de mão: se não precisa estar lá ao abrir, não vai. Essa disciplina produz uma primeira tela que baixa num piscar, que é o ponto de um mini-programa.
| Item | Bundle ingênuo | Bundle disciplinado |
|---|---|---|
| Runtime | Empacotado (1,5 MB) | Fornecido pelo host (0) |
| Biblioteca UI | Biblioteca inteira | Três componentes |
| Imagens | No pacote | CDN |
| Config / dados | JSON empacotado | Buscado em runtime |
| Pacote principal | ~2,4 MB (acima do teto) | ~300 KB |
A concessão que você aceita
Subpacotes e ativos CDN adicionam peças móveis. Um bundle dividido significa mais requisições; uma CDN significa que a primeira pintura espera a rede pelos ativos. Nenhum dos dois é de graça, e uma divisão descuidada troca um gargalo por vários. A versão honesta é que o teto obriga você a pensar no peso — e pensar no peso é o que separa um mini-programa que abre na hora de um que não abre.
A leitura real
Pare de ver o teto de 2 MB como algo contra o qual lutar. É a plataforma fazendo a bronca arquitetônica por você. Com um runtime compartilhado por baixo, esse teto é generoso: é tudo produto, sem motor. Gaste-o na experiência, não no andaime, e o teto deixa de ser um limite e passa a ser por que seu mini-programa se sente mais leve que o app que substituiu.
Fontes
- WeChat Mini Program docs — framework — o teto de tamanho de pacote que obriga bundles enxutos.
- web.dev — Reduce JS payload with code splitting — a disciplina que o teto obriga você a ter.
- MDN — Performance web — como o peso do bundle se traduz direto em atraso de início.
- V8 — Blog do motor JavaScript — por que o custo de parse e compilação escala com o que você envia.
- DataReportal — Digital 2026 — a realidade de baixo banda que faz cada KB contar.