Unity WebGL 构建后本地运行测试指南
Unity 导出 WebGL 项目后,直接双击 index.html 往往无法正常运行。这是因为浏览器安全策略限制了文件协议(file://)下的资源加载和跨域请求。要解决这一问题,我们需要在本地搭建一个简单的 HTTP 服务器。
相比配置 Nginx,使用 Node.js 配合 Express 或 http-server 工具更为轻量快捷,特别适合开发阶段的快速调试。下面介绍如何配置 Node.js 环境并启动服务。
安装 Node.js
首先前往 Node.js 官网下载对应系统的安装包。推荐使用 LTS 版本以保证稳定性。
验证安装是否成功:
node -v
npm -v
如果终端能显示版本号,说明环境已就绪。
配置环境变量
为了避免全局安装模块时出现权限问题,建议自定义 npm 的全局模块路径和缓存目录。
- 创建目录:在安装目录下新建两个文件夹,例如
node_global和node_cache。 - 设置路径:打开命令行(cmd),依次执行以下命令替换为你实际的路径:
npm config set prefix "D:\common\develop\Nodejs\node_global"
npm config set cache "D:\common\develop\Nodejs\node_cache"
- 添加系统变量:将
node_global的 bin 目录添加到系统 PATH 环境变量中,这样就能在任何位置使用 npm 命令。
配置完成后,可以再次输入 npm install express -g 测试全局安装是否顺畅。
启动本地服务
准备好 Unity 导出的 Build 文件夹后,将其放置到 Node.js 项目的根目录或指定路径下。
在项目目录下初始化并安装依赖(如果尚未安装):
npm init -y
npm install express --save
创建一个简单的 server.js 文件来托管静态资源:
const express = require('express');
const path = require('path');
const app = express();
// 指向你的 Build 文件夹路径
app.use(express.static(path.join(__dirname, 'Build')));
app.listen(8080, () => {
console.();
});

