Skip to content

第二步:创建并管理你的项目

环境安装完毕,是时候建立你的创作基地了。一个良好的文件夹组织习惯,能让你的开发之旅更加轻松。

1️⃣ 建立你的“工作区”

我们建议你先在电脑上创建一个总的“工作区”文件夹,用来统一存放你未来所有的 ArenaPro 项目。这就像为你的所有工具和蓝图建立一个专属的工具房,方便管理和查找。

  1. 在你的电脑上,选择一个合适的位置(例如“文档”或 D 盘),创建一个新文件夹。
  2. 为它命名,例如 ArenaPro_ProjectsMyGames
  3. 在 VS Code 中打开这个文件夹
    • 启动 VS Code。
    • 通过顶部菜单栏 文件(File) > 打开文件夹(Open Folder),选中你刚刚创建的 ArenaPro_Projects 文件夹。

2️⃣ 在工作区中创建新项目

现在,你的 VS Code 窗口已经聚焦于工作区,让我们在这个“工具房”里创建第一个真正的项目吧。

  1. 启动项目向导

    • 按下快捷键 F1 (或 Ctrl+Shift+P / Cmd+Shift+P) 打开 VS Code 的命令面板。
    • 输入 新建Arena-Ts项目 并选择对应的命令。
  2. 选择项目模板

    • 在弹出的选项中,我们按照向导给出的提示选择。
    • 如果过程中出现 Ok to proceed? (y) 的提问,请输入 y 并按回车键 以继续。
  3. 确认存放位置并命名

    • 向导会让你选择一个父文件夹来存放项目。
    • 接下来为你的项目命名。在弹出的输入框中:
      • 输入新名称 (推荐):例如 my_first_game,然后回车。这会创建一个同名的新文件夹来存放项目。
      • 输入 .:如果你想把项目文件直接放在当前打开的文件夹里,请输入一个点 . 并回车。

    警告

    ⚠️ 文件夹命名规则 项目名称和路径只能使用英文字母、数字和下划线。请勿使用中文、空格或特殊符号,否则会导致后续的代码编译失败!

    • 正确示例my_awesome_game
    • 错误示例我的超酷游戏

✅ 项目就绪

太棒了!你的第一个项目已经创建成功,并已在 VS Code 中打开。文件浏览器里会显示出标准的项目结构:

  • client/ - 存放客户端代码
  • server/ - 存放服务端代码
  • dao3.config.json - 项目的配置文件
  • ... 其他配置文件

标准的 ArenaPro 项目结构

现在,你本地的“兵工厂”已经准备就绪。下一步,我们将把它与云端的“战场”连接起来。

重要:进入新项目文件夹

如果你刚刚通过输入新名称(如 my_first_game)创建了项目,那么你当前的 VS Code 窗口仍停留在父级工作区。

请务必手动打开刚刚创建的项目文件夹,以便后续的链接和编译操作能够正确执行。

  • 在 VS Code 中选择 文件(File) > 打开文件夹(Open Folder),然后选中 my_first_game

下一步的重要准备:你需要一张“扩展地图”

在我们将本地项目连接到云端之前,请确保你的神岛账号下至少拥有一张“扩展地图”

ArenaPro 的所有强大功能(如代码上传、HMR 热更新、断点调试等)都必须在“扩展地图”中才能使用。

请继续阅读:第三步:连接云端


上一篇:安装开发环境

下一篇:连接云端