企业官网建设流程全解析

1. 项目概述：Cocos Creator本地文件读写不是“直接操作硬盘”，而是受限于运行环境的桥梁工程

“Cocos Creator如何读写本地文件”——这个标题背后藏着一个绝大多数新手会踩坑的认知盲区：Cocos Creator本身不提供跨平台的、无限制的本地文件系统API。它不是Node.js，也不是桌面端Electron应用，更不是原生Android/iOS工程。它的核心定位是“跨平台游戏/交互内容引擎”，而“本地文件读写”这个动作，在Web、小程序、原生App这三大主流发布平台上，其能力边界、安全策略、实现路径天差地别。我带过不少刚从Unity或原生开发转过来的开发者，第一反应就是fs.readFile或FileOutputStream，结果在微信小游戏里连cc.sys.localStorage都报错，最后发现连cc.sys.isNative都返回false——因为默认构建的是Web版本。

所以，这个标题真正要解决的问题，不是“怎么调用一个函数”，而是“如何在Cocos Creator的哲学下，绕过沙箱限制、适配多端差异、安全可靠地完成数据持久化”。关键词“Cocos Creator”“本地文件”“读写”三个词组合起来，指向的是一套环境感知型数据持久化方案设计。它适合三类人：一是正在做离线功能（如关卡编辑器、用户存档、配置热更新）的中高级开发者；二是被H5缓存机制搞晕、想搞懂cc.sys.localStorage和cc.sys.getWritablePath()到底啥关系的新手；三是需要把Web版快速移植到iOS/Android原生包，却发现文件路径全乱套的项目负责人。这篇文章不会教你复制粘贴几行代码就完事，而是带你一层层剥开Cocos Creator的运行时外壳，看清每个平台的数据落盘逻辑，最终给出一套可直接抄作业、带避坑指南的实操方案。

2. 内容整体设计与思路拆解：为什么不能统一用一个API？——从运行时沙箱本质说起

2.1 核心矛盾：引擎抽象层 vs 平台原生限制

Cocos Creator的架构设计遵循“一次编写，多端部署”理念，但它绝非魔法。它的JavaScript层（JSB）和C++底层之间，隔着一道由平台决定的“能力翻译层”。这道层决定了：你写的JS代码，最终调用的是哪个平台的原生API，而这些API的权限，由操作系统和运行环境强制划定。

• Web平台（HTML5）：完全运行在浏览器沙箱内。浏览器出于安全考虑，禁止JS直接访问用户硬盘。你能操作的只有localStorage、sessionStorage、IndexedDB，以及通过<input type="file">触发的用户主动选择文件。cc.sys.getWritablePath()在Web上返回的是一个模拟路径（如/cocos-data/），实际数据全存在IndexedDB里，根本不存在物理文件。

• 微信小游戏/字节跳动小程序等：运行在小程序容器内，有独立的wx.getFileSystemManager()或tt.getFileSystemManager()。它们提供了比Web更强大的文件IO能力（支持创建目录、读写二进制文件），但路径必须是wx.env.USER_DATA_PATH这类受控路径，且文件大小有严格限制（微信目前单文件2MB，总空间50MB）。cc.sys.isNative在这里返回false，但cc.sys.platform是cc.sys.WECHAT_GAME，这是关键识别信号。

• 原生平台（iOS/Android）：这才是真正能“读写本地文件”的地方。Cocos Creator通过JSB桥接，将JS调用翻译成Objective-C/Swift或Java/Kotlin的原生文件操作。cc.sys.getWritablePath()此时返回的是真实的沙盒路径（iOS是Documents目录，Android是getExternalFilesDir），你可以自由创建子目录、读写任意格式文件。但注意：iOS对Documents目录有iCloud备份策略，大文件放这里可能被拒审；Android 10+又引入了Scoped Storage，getExternalStorageDirectory已被废弃。

提示：cc.sys.isNative这个API常被误用。它只表示当前是否运行在Cocos Creator原生打包的App里（即通过build命令生成的.ipa/.apk），而不是指“能否用原生文件API”。在微信小游戏里isNative为false，但你依然能用小程序自己的文件系统——关键在于cc.sys.platform的值。

2.2 方案选型逻辑：三层抽象，按需降级

基于上述差异，我们设计了一套“三层抽象”的读写方案：

1. 最高层：统一接口封装（推荐所有项目使用）
   定义DataStorage类，内部根据cc.sys.platform自动路由到不同实现：

   • cc.sys.WEB→ 使用cc.sys.localStorage（字符串键值对） +cc.loader.loadRes（加载资源）
   • cc.sys.WECHAT_GAME→ 使用wx.getFileSystemManager()（文件系统）
   • cc.sys.IPHONE/cc.sys.ANDROID→ 使用jsb.fileUtils（原生文件工具）

2. 中间层：平台特化实现（必须针对各平台单独编码）
   每个平台的实现都要处理其特有的约束：

   • Web：localStorage容量仅5MB，且只能存字符串，大对象必须JSON.stringify+encodeURIComponent编码，读取时反向解码。
   • 小程序：wx.getFileSystemManager().writeFile是异步的，但readFileSync不存在，必须用readFile+Promise包装；路径必须用wx.env.USER_DATA_PATH拼接，不能硬编码。
   • 原生：jsb.fileUtils的writeStringToFile只能写文本，写二进制得用writeDataToFile；getWritablePath()返回路径末尾不带/，拼接子路径时必须手动加/，否则iOS会报错。

3. 最底层：兜底方案（应对极端情况）
   当某平台API不可用（如用户禁用了微信小程序文件权限），自动降级到内存缓存（Map对象），并记录日志提醒开发者。绝不让整个存档系统崩溃。

这套设计的核心思想是：把平台差异性锁死在数据层，业务逻辑层永远只调用DataStorage.save('player', data)和DataStorage.load('player')。我参与过一个教育类App，最初用localStorage硬编码，后来要上微信小程序，三天改崩两次，最后重构成这套三层结构，后续接入抖音小程序只花了2小时。

2.3 为什么不用第三方库？——轻量与可控性的权衡

网上有些教程推荐用cordova-plugin-file或capacitor-plugin-file，但对Cocos Creator项目来说，这是典型的“杀鸡用牛刀”。原因有三：

• 体积膨胀：一个cordova-plugin-file插件会引入整个Cordova框架，而Cocos Creator原生构建根本不依赖Cordova，强行集成会导致iOS构建失败（找不到CDVPlugin头文件）。
• 生命周期冲突：Cordova插件的deviceready事件与Cocos Creator的cc.game.onStart时机不一致，容易出现“插件未就绪就调用文件API”的竞态问题。
• 维护黑洞：插件更新滞后于Cocos Creator版本。去年有个项目用了capacitor-plugin-file，升级到Cocos Creator 3.8后，插件的readAsText方法返回undefined，查了两天才发现是Capacitor 4.x的API变更，而Cocos Creator 3.8的JSB桥接层没同步更新。

所以，我的经验是：原生能力够用就坚决不用第三方。Cocos Creator官方提供的jsb.fileUtils、cc.sys、小程序官方API，已经覆盖95%的场景。剩下5%，用纯JS方案兜底（如内存缓存+用户提示），比引入一个黑盒插件更可控、更易调试。

3. 核心细节解析与实操要点：从路径、编码到权限，每一个细节都是坑

3.1 路径拼接：看似简单，实则处处是雷

路径问题，是本地文件读写里最隐蔽的“静默杀手”。它不会报错，但会让你的数据永远找不到。

• Web平台：cc.sys.getWritablePath()返回/cocos-data/，但这只是逻辑路径。真实数据存在IndexedDB的cocos_data_store数据库里。你调用cc.sys.getWritablePath() + 'save.json'，得到/cocos-data/save.json，这个字符串只是个Key，不是物理路径。所以，Web平台根本不需要拼接路径，直接用cc.sys.localStorage.setItem('save', JSON.stringify(data))即可。

• 小程序平台：wx.env.USER_DATA_PATH返回类似wxfile://.../user_data/的URL，但wx.getFileSystemManager()要求路径是绝对路径，且必须以wxfile://开头。错误做法：wx.env.USER_DATA_PATH + 'save.json'→wxfile://.../user_data/save.json（正确）；但如果你写成wx.env.USER_DATA_PATH + '/save.json'，多了一个/，在某些安卓机型上会变成wxfile://.../user_data//save.json，导致writeFile失败。正确姿势是：用path.join(wx.env.USER_DATA_PATH, 'save.json')，或手动确保只有一处/分隔符。

• 原生平台：cc.sys.getWritablePath()在iOS返回/var/mobile/Containers/Data/Application/XXXX/Documents，在Android返回/data/user/0/com.company.game/files。关键点来了：这个路径末尾不带/。如果你写cc.sys.getWritablePath() + 'save.json'，iOS上会变成/Documentssave.json（少了个/），直接报错No such file or directory。而Android可能侥幸成功，造成平台差异性Bug。标准解法是：定义一个joinPath工具函数：

  function joinPath(base: string, ...paths: string[]): string { let result = base; for (const p of paths) { if (p) { // 移除base末尾的/，移除p开头的/，再拼接 result = result.replace(/\/+$/, '') + '/' + p.replace(/^\/+/, ''); } } return result; } // 使用：const fullPath = joinPath(cc.sys.getWritablePath(), 'saves', 'player.json');

注意：cc.sys.getSafeUrl这个API在Cocos Creator 3.x里已废弃，不要用。它曾用于生成Web资源URL，但和文件读写无关，混淆使用会导致cc.loader.load加载失败。

3.2 编码与序列化：JSON不是万能的，二进制才是真相

很多开发者以为“存档就是JSON.stringify(obj)”，这在Web和小程序上勉强可行，但在原生平台，尤其是存图片、音频、加密数据时，会出大问题。

• 文本数据（JSON/配置）：
  Web和小程序用JSON.stringify没问题，但要注意Date对象、undefined、function会被忽略。最佳实践是：用JSON.stringify(obj, null, 2)（带缩进）存档，方便调试；用JSON.parse(str)读取。但必须包裹try...catch，因为用户可能手动编辑了JSON文件导致语法错误。

• 二进制数据（图片、音频、加密存档）：
  这是jsb.fileUtils的主战场。writeStringToFile只能写UTF-8文本，写二进制必须用writeDataToFile。而writeDataToFile接收的是ArrayBuffer或Uint8Array。常见错误：

  • 错误1：jsb.fileUtils.writeStringToFile(data, path)→data是ArrayBuffer，但API期望string，静默失败。
  • 错误2：new Uint8Array(data).buffer→data已经是ArrayBuffer，再new Uint8Array是多余操作，还可能改变数据。

  正确流程：

  1. 从网络加载图片：cc.loader.load('res/img.png', cc.Texture2D)→ 得到cc.Texture2D对象。
  2. 获取像素数据：const texture = img.getComponent(cc.Sprite).spriteFrame.texture; const data = texture.getPixelData();→data是Uint8Array。
  3. 写入文件：jsb.fileUtils.writeDataToFile(data.buffer, fullPath);（注意是data.buffer，不是data）。

• 跨平台兼容性陷阱：
  同一个ArrayBuffer，在Web上用Blob保存，在小程序用wx.getFileSystemManager().writeFile({data: arrayBuffer})，在原生用jsb.fileUtils.writeDataToFile(arrayBuffer, path)。但arrayBuffer本身是通用的，所以你的DataStorage类可以这样设计：

  async saveBinary(key: string, data: ArrayBuffer): Promise<boolean> { const path = this.getPath(key); switch (cc.sys.platform) { case cc.sys.WEB: // Web不支持直接存ArrayBuffer，转成base64存localStorage或用IndexedDB const base64 = this.arrayBufferToBase64(data); cc.sys.localStorage.setItem(key, base64); return true; case cc.sys.WECHAT_GAME: return new Promise((resolve) => { wx.getFileSystemManager().writeFile({ filePath: path, data: data, success: () => resolve(true), fail: () => resolve(false) }); }); default: return jsb.fileUtils.writeDataToFile(data, path); } }

3.3 权限与异常处理：用户拒绝=你的App崩溃？

文件操作是高风险操作，必须假设每一次调用都可能失败。

• 小程序权限：微信小游戏没有单独的“文件存储权限”，但wx.getFileSystemManager()的writeFile在首次调用时，如果用户手机存储空间不足，会静默失败。必须检查fail回调，并在UI上友好提示：“存档失败，请检查手机存储空间”。不能只打印console.error。

• 原生平台权限（Android）：Cocos Creator 3.x默认targetSdkVersion是30（Android 11），Scoped Storage强制启用。jsb.fileUtils的getWritablePath()返回的是App专属目录，无需申请WRITE_EXTERNAL_STORAGE权限。但如果你错误地用了getExternalStorageDirectory()，就必须在AndroidManifest.xml里声明权限，且Android 11+该权限已失效。结论：永远用getWritablePath()，别碰外部存储。

• 统一异常处理模板：
  所有文件操作必须包裹try...catch，并区分错误类型：

  try { if (cc.sys.platform === cc.sys.WEB) { cc.sys.localStorage.setItem(key, value); } else if (cc.sys.platform === cc.sys.WECHAT_GAME) { await new Promise((resolve, reject) => { wx.getFileSystemManager().writeFile({ filePath: fullPath, data: value, success: resolve, fail: reject }); }); } else { jsb.fileUtils.writeStringToFile(value, fullPath); } } catch (e) { // e可能是字符串（Web）、Object（小程序）、Error（原生） const errorMsg = e instanceof Error ? e.message : String(e); console.error(`[DataStorage] Save failed for ${key}:`, errorMsg); // 触发全局存档失败事件，UI层可弹窗提示 cc.systemEvent.emit('storage-save-failed', { key, error: errorMsg }); }

4. 实操过程与核心环节实现：从零开始搭建一个跨平台存档系统

4.1 环境准备与基础类搭建

我们以Cocos Creator 3.8.2为基准（这是目前最稳定的LTS版本），创建一个名为DataStorage的单例管理类。它不依赖任何外部库，纯TypeScript实现。

第一步：创建DataStorage.ts文件

// assets/scripts/utils/DataStorage.ts const { ccclass, property } = cc._decorator; @ccclass export default class DataStorage { private static _instance: DataStorage = null; public static getInstance(): DataStorage { if (!DataStorage._instance) { DataStorage._instance = new DataStorage(); } return DataStorage._instance; } private constructor() { // 私有构造，防止new } // 存档根目录，根据不同平台动态计算 private getRootPath(): string { switch (cc.sys.platform) { case cc.sys.WEB: return ''; // Web不使用路径 case cc.sys.WECHAT_GAME: return wx.env.USER_DATA_PATH; case cc.sys.IPHONE: case cc.sys.ANDROID: return cc.sys.getWritablePath(); default: return ''; } } // 路径拼接工具（防错版） private joinPath(...paths: string[]): string { let result = ''; for (let i = 0; i < paths.length; i++) { const p = paths[i]; if (!p) continue; if (i === 0) { result = p.replace(/\/+$/, ''); } else { result += '/' + p.replace(/^\/+/, ''); } } return result; } // 获取完整文件路径 private getPath(key: string): string { const root = this.getRootPath(); if (cc.sys.platform === cc.sys.WEB) { return key; // Web用key当key } return this.joinPath(root, 'saves', `${key}.json`); } }

第二步：实现核心读写方法

// 接续上面的DataStorage类 export default class DataStorage { // ... 构造函数和工具方法 ... // 保存JSON数据（通用） public save<T>(key: string, data: T): boolean { try { const str = JSON.stringify(data, null, 2); switch (cc.sys.platform) { case cc.sys.WEB: cc.sys.localStorage.setItem(key, str); break; case cc.sys.WECHAT_GAME: wx.getFileSystemManager().writeFile({ filePath: this.getPath(key), data: str, encoding: 'utf8', success: () => {}, fail: (err) => console.error('WX save fail:', err) }); break; case cc.sys.IPHONE: case cc.sys.ANDROID: if (!jsb.fileUtils) { console.warn('jsb.fileUtils not available'); return false; } jsb.fileUtils.writeStringToFile(str, this.getPath(key)); break; default: console.warn('Unsupported platform for save:', cc.sys.platform); return false; } return true; } catch (e) { console.error(`Save ${key} failed:`, e); return false; } } // 加载JSON数据（通用） public load<T>(key: string): T | null { try { let str: string | null = null; switch (cc.sys.platform) { case cc.sys.WEB: str = cc.sys.localStorage.getItem(key); break; case cc.sys.WECHAT_GAME: try { const res = wx.getFileSystemManager().readFileSync(this.getPath(key), 'utf8'); str = res as string; } catch (e) { // 同步读取可能失败，尝试异步 console.warn('Sync read failed, fallback to async'); return null; // 异步需另写方法 } break; case cc.sys.IPHONE: case cc.sys.ANDROID: if (!jsb.fileUtils) return null; str = jsb.fileUtils.getStringFromFile(this.getPath(key)); break; default: return null; } if (!str) return null; return JSON.parse(str) as T; } catch (e) { console.error(`Load ${key} failed:`, e); return null; } } // 异步加载（小程序专用，避免阻塞主线程） public async loadAsync<T>(key: string): Promise<T | null> { if (cc.sys.platform !== cc.sys.WECHAT_GAME) { return this.load(key); } try { const res = await new Promise<any>((resolve, reject) => { wx.getFileSystemManager().readFile({ filePath: this.getPath(key), encoding: 'utf8', success: resolve, fail: reject }); }); return JSON.parse(res.data) as T; } catch (e) { console.error(`Async load ${key} failed:`, e); return null; } } }

第三步：在游戏启动时初始化

// assets/scripts/app/AppStart.ts const { ccclass } = cc._decorator; @ccclass export default class AppStart extends cc.Component { start() { // 游戏启动时，检查存档目录是否存在（原生平台） if (cc.sys.isNative && jsb.fileUtils) { const savesPath = cc.sys.join(cc.sys.getWritablePath(), 'saves'); if (!jsb.fileUtils.isDirectoryExist(savesPath)) { jsb.fileUtils.createDirectory(savesPath); } } // 加载玩家存档 const playerData = DataStorage.getInstance().load<{level: number, coins: number}>('player'); if (playerData) { console.log('Player loaded:', playerData); } else { console.log('No player data, starting new game'); } } }

4.2 高级功能：二进制存档与资源热更新

存档不只是JSON，有时你需要存一张用户截图、一段录音，或者一个加密的存档文件。

实现截图存档功能：

// 在DataStorage类中添加 public async saveScreenshot(key: string): Promise<boolean> { if (!cc.sys.isNative) { console.warn('Screenshot save only supported on native platforms'); return false; } try { // 创建渲染纹理，捕获当前屏幕 const renderTexture = new cc.RenderTexture(); const camera = cc.Camera.main; if (!camera) return false; // 设置渲染纹理大小 const size = cc.view.getVisibleSize(); renderTexture.initWithSize(size.width, size.height); // 渲染到纹理 camera.render(renderTexture); // 获取像素数据（RGBA, 4 bytes per pixel） const data = renderTexture.readPixels(); const width = renderTexture.width; const height = renderTexture.height; // 转换为PNG格式（需要额外的PNG编码库，此处简化为RAW） // 实际项目中，推荐用`pngjs`或`pixijs`的`utils.TextureUtils.encode`，但需自行集成 // 这里我们直接存RAW数据，后缀用.bin const fullPath = this.joinPath(this.getRootPath(), 'screenshots', `${key}.bin`); // 写入文件 jsb.fileUtils.writeDataToFile(data.buffer, fullPath); console.log('Screenshot saved to:', fullPath); return true; } catch (e) { console.error('Save screenshot failed:', e); return false; } }

资源热更新（替代传统cc.loader.loadRes）：

// 从服务器下载新资源并本地缓存 public async downloadAndCache(url: string, key: string): Promise<string | null> { try { // 1. 下载文件 const response = await fetch(url); if (!response.ok) throw new Error(`HTTP ${response.status}`); const arrayBuffer = await response.arrayBuffer(); const fullPath = this.getPath(key); // 2. 根据平台写入 switch (cc.sys.platform) { case cc.sys.WEB: // Web无法直接存二进制，用IndexedDB或转base64存localStorage（小文件） const base64 = this.arrayBufferToBase64(arrayBuffer); cc.sys.localStorage.setItem(key, base64); return `data:application/octet-stream;base64,${base64}`; case cc.sys.WECHAT_GAME: wx.getFileSystemManager().writeFile({ filePath: fullPath, data: arrayBuffer, success: () => console.log('Download cached'), fail: (e) => console.error('Cache fail:', e) }); return fullPath; default: jsb.fileUtils.writeDataToFile(arrayBuffer, fullPath); return fullPath; } } catch (e) { console.error('Download and cache failed:', e); return null; } } private arrayBufferToBase64(buffer: ArrayBuffer): string { let binary = ''; const bytes = new Uint8Array(buffer); const len = bytes.byteLength; for (let i = 0; i < len; i++) { binary += String.fromCharCode(bytes[i]); } return btoa(binary); }

4.3 实测性能与容量测试：别让存档拖垮你的游戏

我用一个真实项目数据告诉你：存档大小和频率，直接影响用户体验。

实测结论：

• Web平台：localStorage绝对不能存超过1MB的数据。超过后，Chrome会抛QuotaExceededError，Firefox会静默截断。解决方案：用IndexedDB替代，Cocos Creator 3.x内置了cc.sys.localStorage的indexedDB后备方案，但需手动开启（在project.config.json里设置"useIndexedDB": true）。
• 小程序平台：单次writeFile最大2MB，但USER_DATA_PATH总空间50MB。如果你的存档是10MB，必须分片（如save_001.bin,save_002.bin），并在加载时合并。
• 原生平台：Documents目录在iOS会被iCloud备份，苹果审核指南明确指出：“不应备份用户生成的大文件”。正确做法：iOS上用NSCachesDirectory（对应cc.sys.getTempPath()），Android上用getCacheDir()，这些路径不备份，且系统会自动清理。

注意：cc.sys.getTempPath()在iOS返回/Library/Caches，在Android返回/data/user/0/com.company.game/cache。它比getWritablePath()更适合存临时、可丢弃的数据（如截图缓存、下载中的资源）。getWritablePath()应只用于用户明确要保存的数据（如游戏进度）。

5. 常见问题与排查技巧实录：那些让我熬夜到凌晨三点的Bug

5.1 典型问题速查表

5.2 独家避坑技巧：来自血泪教训

技巧1：永远用cc.sys.platform，而不是cc.sys.isNative来判断文件能力
我曾经在一个项目里，用isNative判断是否走原生路径，结果在微信小游戏里isNative是false，但platform是WECHAT_GAME，导致文件操作直接跳过，存档全丢了。记住：isNative只代表“是不是Cocos原生App”，platform才代表“当前运行在哪种环境”。

技巧2：小程序路径必须用wx.env.USER_DATA_PATH，不能用wx.env.USER_DATA_PATH + '/'
有一次，我在路径拼接时写了wx.env.USER_DATA_PATH + '/' + 'save.json'，在iOS微信上正常，但在华为鸿蒙系统上，USER_DATA_PATH末尾自带/，结果变成//save.json，writeFile静默失败。解决方案：用path.posix.join或自己写的joinPath，它会自动去重/。

技巧3：原生平台写入前，先创建父目录
jsb.fileUtils.writeStringToFile不会自动创建不存在的目录。如果你写/Documents/saves/player.json，但saves目录不存在，就会失败。必须在写入前检查并创建：

const dir = cc.sys.join(cc.sys.getWritablePath(), 'saves'); if (!jsb.fileUtils.isDirectoryExist(dir)) { jsb.fileUtils.createDirectory(dir); }

技巧4：Web平台存档，用localStorage+IndexedDB双保险
localStorage容量小，IndexedDB复杂。我的方案是：小数据（<10KB）用localStorage，大数据用IndexedDB，并封装统一接口。Cocos Creator 3.x的cc.sys.localStorage底层已自动切换，但需确保project.config.json里"useIndexedDB": true。

技巧5：存档版本管理，避免旧版数据污染新版
游戏更新后，存档结构可能变化（如新增字段）。直接JSON.parse旧数据会报错。解决方案：在存档对象里加version字段，加载时做迁移：

interface PlayerData { version: number; level: number; coins: number; } public loadPlayer(): PlayerData | null { const data = this.load<PlayerData>('player'); if (!data) return null; // 版本迁移 if (data.version < 2) { data.coins = data.coins || 0; // v1没有coins字段，设默认值 data.version = 2; this.save('player', data); // 自动保存新版本 } return data; }

5.3 调试神器：跨平台文件查看器

开发时，你不可能每次都在真机上用Xcode或ADB看文件。我自建了一个简易的“存档查看器”场景：

1. 创建一个DebugStorageScene，里面放一个ScrollView和RichText。
2. 在start里，遍历cc.sys.getWritablePath()下的saves目录（原生）或读取localStorage所有key（Web）。
3. 点击某个存档，用JSON.stringify(data, null, 2)格式化显示。
4. 支持“编辑并保存”按钮，直接修改JSON后回写。

这个工具在团队协作时救了大命——策划可以直接在手机上改数值，不用等程序员打包。

6. 性能优化与未来演进：当你的游戏用户突破百万

6.1 大数据量存档的优化策略

当你的游戏有100万用户，平均每个用户存档5MB，总数据量就是500TB。这时候，光靠本地文件就不够了。

• 增量存档（Delta Save）：不存全量，只存变化。例如，玩家只改了金币数，就只存{ "coins": 1000 }，服务端合并时用Object.assign(old, delta)。Cocos Creator里实现很简单：

  public saveDelta(key: string, delta: Partial<any>): boolean { const old = this.load<any>(key) || {}; const merged = Object.assign({}, old, delta); return this.save(key, merged); }

• 压缩存档：对JSON存档用lz-string库压缩（Web/小程序），原生平台用zlib（需自己编译JSB模块）。实测1MB JSON可压到300KB，节省70%空间。

• 分片存储：把一个大存档拆成多个小文件（player_meta.json,player_inventory.json,player_skills.json），按需加载，避免一次读取整个大文件阻塞主线程。

6.2 云同步的平滑过渡方案

本地存档是基础，但用户换手机后数据就丢了。云同步是终极方案，但不能一刀切。

• 渐进式云同步：
  1. 第一阶段：本地存档 + 云端备份（用户点击“