本页目录
官方资料整理
Windows
macOS
Cocos Creator 开发与测试环境部署
安装 Cocos Dashboard 与 Creator 编辑器，打开现有工程并预览运行。
本篇为 Cocos Creator 通用环境教程。以 3.x 为主流；2.x 工程不可直接当 3.x 打开。文档：Cocos Creator 手册。
1. 安装 Dashboard 与编辑器
- 从 Cocos 产品下载 安装 Cocos Dashboard。
- 在 Dashboard 中安装与目标工程
package.json/ 项目设置匹配的 Creator 版本。 - 按需安装构建模块（Web / 原生平台）。原生构建还需对应 Android SDK / Xcode 等，跟做 Web 预览可先跳过。
2. 打开工程并预览
- Dashboard → 打开项目目录（含
assets、package.json、settings等）。 - 编辑器打开后，点击 预览 在浏览器或模拟器中运行。
- 版本不匹配时，优先安装仓库指定的 Creator，而不是强行升级。
3. 常见问题
- 扩展商店插件缺失：按 README 安装扩展后重启编辑器。
- 脚本报错：确认 TypeScript 编译无错误，查看控制台。
- 原生构建失败：单独排查 JDK、NDK、签名与构建模板，与编辑器预览问题分开处理。