当前位置：首页 > 电脑教程 > 正文

命令行如何快速新建cocos项目？

安装Cocos Dashboard后，在命令行执行 cocos new 项目名 -p 包名 -l 语言 -d 路径 -e 引擎版本，指定项目名称、包名、语言、路径和Cocos引擎版本即可创建。

环境准备（必需步骤）

  1. 安装Node.js

    • 访问 Node.js官网 下载LTS版本（建议v18+）
    • 安装后验证： 
      node -v  # 显示版本号如 v18.16.0
npm -v   # 显示版本号如 9.5.0

  2. 安装Cocos Creator

    • 从官网下载并安装编辑器（至少v3.4+）

  3. 全局安装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>

常用模板：

命令行如何快速新建cocos项目？ 第1张

  • empty：空项目
  • simple：基础示例
  • ui-demo：UI组件示例
  • 查看全部模板： 
    cocos list -t

项目初始化与启动

  1. 进入项目目录 

    cd <project-name>

  2. 安装依赖 

    npm install  # 安装JS/TS依赖

  3. 启动项目 

    cocos run --web  # 在浏览器运行
cocos run -p android  # 构建Android项目（需配置SDK）

常见问题解决

  • 报错：cocos: command not found
    重新安装CLI并检查环境变量：

    命令行如何快速新建cocos项目？ 第2张

    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+（如需安卓构建）

最佳实践建议

  1. 项目结构规范

    • /assets：存放资源文件
    • /build：编译输出目录
    • /packages：插件管理

  2. 版本控制
    在项目根目录添加.gitignore

    命令行如何快速新建cocos项目？ 第3张

    /temp/
/library/
/local/
/build/
node_modules/

  3. 持续更新工具
    定期升级CLI和编辑器： 

    npm update -g @cocos/creator

引用说明

  • Cocos官方文档：CLI使用指南
  • Node.js安装指南：Node.js官网
  • 镜像加速源：npmmirror.com

重要提示基于Cocos Creator 3.8验证，适用于Windows/macOS/Linux系统，操作前请确保满足环境要求，命令行工具版本过低可能导致兼容性问题。

Cocos Creator命令行操作新建Cocos项目
0

相关文章