CocosCreator 2.x/3.x游戏体积超过4M时的解决方案

CocosCreator 2.x/3.x游戏体积超过4M时，微信开发者工具会提示：

message：自动预览 Error: 系统错误，错误码：80051,source size 9521KB exceed max limit 4MB [20260109 09:38:16][wx19af6aec97c617a0]
appid: wx19af6aec97c617a0
openid: o6zAJs3OUPDhB0FRHhgqfRXBvyYQ
ideVersion: 2.01.2510260
osType: win32-x64
time: 2026-01-09 09:38:24

核心问题是：使用 Cocos Creator 3.8.7 编译微信小游戏时，打包后的源码体积（9521KB）超过了微信小游戏主包 4MB 的限制，触发了 80051 错误码。你的核心需求是通过微信小游戏分包来拆分主包体积，解决这个超限问题。

一、Cocos Creator 3.8.7 微信小游戏分包实现步骤

Cocos Creator 对微信小游戏分包有原生支持，核心思路是将非核心资源/代码拆分到子包，只有用户进入对应功能时才加载，从而减小主包体积。以下是完整可落地的操作步骤：

1. 基础配置：在 Creator 中设置分包规则

首先在 Cocos Creator 编辑器内完成分包的基础配置：

• 打开你的项目，进入 项目 -> 项目设置 -> 功能裁剪/分包配置（不同版本可能显示为「分包配置」）。
• 点击「添加分包」，填写分包名称（如 subPackage1）、分包根目录（如 assets/subPackage1）。
• 关键：将非首屏加载的资源（如关卡资源、次要功能的图片/音频、非核心脚本）移动到该分包目录下。

2. 代码层面：按需加载分包资源

避免分包资源被主包提前引用，确保只有触发对应功能时才加载：

// 主包代码示例：点击按钮后加载分包并进入对应场景
import { _decorator, Component, Node, director } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('MainPackageController')
export class MainPackageController extends Component {
    // 点击加载分包的按钮回调
    public async loadSubPackage() {
        try {
            // 1. 加载分包（分包名称与编辑器配置一致）
            const subPackage = await wx.loadSubpackage({
                name: 'subPackage1' // 你的分包名称
            });
            console.log('分包加载完成：', subPackage);

            // 2. 加载分包内的场景（假设分包内有 "Level2" 场景）
            await director.loadScene('Level2');
        } catch (error) {
            console.error('分包加载失败：', error);
        }
    }
}

3. 编译与微信开发者工具配置

• 在 Cocos Creator 中选择「发布 -> 微信小游戏」，发布前确认：
  • 「分包配置」已勾选，且分包目录正确。
  • 「压缩资源」「混淆代码」等优化选项已开启（进一步减小体积）。
• 发布完成后，打开微信开发者工具，检查 game.json 文件（Creator 会自动生成），确认分包配置生效：

  {
      "deviceOrientation": "portrait",
      "subpackages": [
          {
              "name": "subPackage1",
              "root": "subPackage1/"
          }
      ],
      "networkTimeout": {
          "request": 5000,
          "connectSocket": 5000
      }
  }
  

4. 额外体积优化（辅助解决超限）

如果分包后主包仍接近 4MB，可做以下优化：

• 图片资源：将 png/jpg 转为 webp 格式（微信小游戏支持），压缩图片分辨率。
• 音频资源：降低音频比特率，非必要音频改为远程加载。
• 脚本优化：删除无用代码，使用 Creator 的「代码裁剪」功能（项目设置 -> 功能裁剪）。
• 资源远程托管：将超大资源（如超过 1MB 的图片/音频）放到微信云存储/CDN，通过 wx.downloadFile 加载。

二、验证是否解决问题

1. 在微信开发者工具中，点击「详情 -> 基本信息」，查看「本地代码包大小」：
   • 主包大小需 ≤ 4MB（4096KB）。
   • 分包大小无严格限制（总包大小微信限制为 20MB，超过需走「小游戏代码包体积扩展」申请）。
2. 点击预览/真机调试，若不再出现 80051 错误，且分包功能正常加载，说明配置成功。

总结

1. 核心解决思路：通过 Cocos Creator 编辑器配置分包目录，将非核心资源拆分到子包，避免主包体积超过 4MB 限制。
2. 关键操作：确保分包资源不被主包提前引用，通过 wx.loadSubpackage 按需加载分包。
3. 辅助优化：开启资源压缩、格式转换、远程托管，进一步减小主包体积。

按照以上步骤配置后，你的主包体积会大幅降低，就能解决 80051 错误码的问题。如果分包后仍有问题，优先检查是否有分包资源被主包意外引用，或进一步压缩主包内的核心资源。