安装Cocos Dashboard后，在命令行执行
cocos new 项目名 -p 包名 -l 语言 -d 路径 -e 引擎版本，指定项目名称、包名、语言、路径和Cocos引擎版本即可创建。环境准备（必需步骤）
-
安装Node.js
- 访问 Node.js官网 下载LTS版本（建议v18+）
- 安装后验证：
node -v # 显示版本号如 v18.16.0 npm -v # 显示版本号如 9.5.0
-
- 从官网下载并安装编辑器（至少v3.4+）
-
全局安装Cocos CLI工具
npm install -g @cocos/creator
- 安装后验证：
cocos -v # 显示版本号如 3.8.1
- 安装后验证：
命令行创建项目
方法1：快速创建（使用默认模板）
cocos new <project-name> -l cpp # 创建C++项目 # 或 cocos new <project-name> -l js # 创建JavaScript项目 # 或 cocos new <project-name> -l ts # 创建TypeScript项目
参数说明：
<project-name>：自定义项目名称（英文+数字，不含空格）-l：指定语言类型（cpp/js/ts）
方法2：自定义模板（高级）
cocos new <project-name> -t <template-name>
常用模板：
empty：空项目simple：基础示例ui-demo：UI组件示例- 查看全部模板：
cocos list -t
项目初始化与启动
-
进入项目目录
cd <project-name>
-
安装依赖
npm install # 安装JS/TS依赖
-
启动项目
cocos run --web # 在浏览器运行 cocos run -p android # 构建Android项目（需配置SDK）
常见问题解决
-
报错：
cocos: command not found
重新安装CLI并检查环境变量：npm uninstall -g @cocos/creator npm install -g @cocos/creator
-
模板下载失败
使用国内镜像加速：npm config set registry https://registry.npmmirror.com
-
C++项目编译失败
确保已安装：
- Python 2.7/3.7+
- CMake 3.18+
- Android NDK r21+（如需安卓构建）
最佳实践建议
-
项目结构规范
/assets：存放资源文件/build：编译输出目录/packages：插件管理
-
版本控制
在项目根目录添加.gitignore/temp/ /library/ /local/ /build/ node_modules/ -
持续更新工具
定期升级CLI和编辑器：npm update -g @cocos/creator
引用说明
- Cocos官方文档：CLI使用指南
- Node.js安装指南：Node.js官网
- 镜像加速源：npmmirror.com
重要提示基于Cocos Creator 3.8验证，适用于Windows/macOS/Linux系统，操作前请确保满足环境要求，命令行工具版本过低可能导致兼容性问题。
原创文章，发布者：酷盾叔，转转请注明出处：https://www.kd.cn/ask/28573.html
