不同平台加载本地JSON文件方式不同：App和小程序可用require同步加载static/等源码目录下的JSON；App端动态读取需用plus.io异步读取\_www/路径；H5端必须用uni.request或fetch请求部署后的静态URL。
uni-app 加载本地 JSON 文件，不能用 import，也不能直接用 uni.request 读取项目内路径（比如 @/data/config.json），否则 H5 正常、App 和小程序会报错或返回空。核心就一条：**不同平台加载方式完全不同，必须按端区分处理**。
require 导入只适用于非 H5 端（App、微信小程序等）
这是最常用也最容易踩坑的方式。只有 App 和小程序能用 require 同步加载 JSON 文件，且文件必须放在项目源码目录下（如 static/ 或 common/），不能放 unpackage/ 或构建后路径里。
-
require只支持相对路径，且路径必须以@/或./开头，不能是绝对路径（如/static/data.json） - JSON 文件内容必须是合法 JSON 格式，字段名和字符串值都得用双引号，
{'id':1}会报错，必须写成{"id":1} - H5 端不支持
require加载 JSON，运行时直接抛Cannot resolve module错误 - 示例：
const data = require('@/static/city.json')—— 这行代码在 App 和小程序里能拿到对象，在 H5 里会崩
static 目录 + plus.io 是 App 端唯一可靠的异步读取方式
App 端想动态读（比如用户触发后才加载）、或读取运行时生成/修改的 JSON 文件，就得用 plus.io。文件必须放在 static/ 下，因为只有这个目录会被原样复制到 App 的 _www/ 根目录中。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 路径拼接要加
_www/前缀，例如读static/config.json，实际传给plus.io.resolveLocalFileSystemURL的是'_www/static/config.json' - 必须用
plus.io.FileReader.readAsText，不能用XMLHttpRequest或fetch，后者在 App 端无法访问本地文件系统 - 该方法只在 App 端有效，微信小程序、H5 调用会直接报
plus is not defined - 示例函数片段：
function readStaticFile(url) { return new Promise((resolve, reject) => { plus.io.resolveLocalFileSystemURL('_www/' + url, (entry) => { entry.file((file) => { const reader = new plus.io.FileReader(); reader.onloadend = (e) => resolve(JSON.parse(e.target.result)); reader.readAsText(file, 'utf-8'); }); }); }); }
H5 端必须用 fetch 或 uni.request，且 JSON 文件需部署为静态资源
H5 是浏览器环境，只能走 HTTP 请求。这意味着你不能把 JSON 放在 @/ 下指望打包后自动可访问——它得变成一个真实 URL，比如 /static/data.json，且服务器要能返回该文件。
- 推荐用
uni.request({ url: '/static/data.json', responseType: 'text' })，避免自动 JSON 解析失败（比如 BOM 或编码问题） - 如果用
fetch('/static/data.json')，注意 H5 端可能因跨域或 MIME 类型被拦截，确保服务器返回Content-Type: application/json - 千万别在 H5 里混用
require，编译期看似能过，运行时直接白屏 - 路径必须是相对于 H5 页面根路径的，
@/别名在运行时不生效
跨端统一方案：封装条件判断 + 预加载逻辑
真正在项目里用，没人会为每个 JSON 写三套逻辑。关键是把平台判断收口，再配合生命周期控制加载时机。
- 用
uni.getSystemInfoSync().platform判断当前端，而不是靠编译条件（#ifdef APP-PLUS在某些异步场景下不可靠） - 数据量小（require + 多端兼容 fallback：先 try
require，失败再走uni.request - 省市区这类大文件，不要一进来就全量
require，改用「用户点击触发 → 按需加载」，避免首屏卡顿 - 注意 JSON 中的中文路径、特殊字符，在 Windows 下编辑后容易带 BOM，导致解析失败，建议用 VS Code 保存为 UTF-8 无 BOM 格式
最麻烦的不是怎么读，而是读完之后没做容错：比如 require 成功但 JSON 格式错了一逗号，整个页面就挂了；或者 plus.io 读取时文件不存在，没 catch 就静默失败。这些边界情况，比选哪种方式更重要。
