第二步:创建并管理你的项目
环境安装完毕,是时候建立你的创作基地了。一个良好的文件夹组织习惯,能让你的开发之旅更加轻松。
1️⃣ 建立你的“工作区”
我们建议你先在电脑上创建一个总的“工作区”文件夹,用来统一存放你未来所有的 ArenaPro 项目。这就像为你的所有工具和蓝图建立一个专属的工具房,方便管理和查找。
- 在你的电脑上,选择一个合适的位置(例如“文档”或 D 盘),创建一个新文件夹。
- 为它命名,例如
ArenaPro_Projects
或MyGames
。 - 在 VS Code 中打开这个文件夹:
- 启动 VS Code。
- 通过顶部菜单栏
文件(File)
>打开文件夹(Open Folder)
,选中你刚刚创建的ArenaPro_Projects
文件夹。
2️⃣ 在工作区中创建新项目
现在,你的 VS Code 窗口已经聚焦于工作区,让我们在这个“工具房”里创建第一个真正的项目吧。
启动项目向导:
- 按下快捷键
F1
(或Ctrl+Shift+P
/Cmd+Shift+P
) 打开 VS Code 的命令面板。 - 输入
新建Arena-Ts项目
并选择对应的命令。
- 按下快捷键
选择项目模板:
- 在弹出的选项中,我们按照向导给出的提示选择。
- 如果过程中出现
Ok to proceed? (y)
的提问,请输入y
并按回车键 以继续。
确认存放位置并命名:
- 向导会让你选择一个父文件夹来存放项目。
- 接下来为你的项目命名。在弹出的输入框中:
- 输入新名称 (推荐):例如
my_first_game
,然后回车。这会创建一个同名的新文件夹来存放项目。 - 输入
.
:如果你想把项目文件直接放在当前打开的文件夹里,请输入一个点.
并回车。
- 输入新名称 (推荐):例如
警告
⚠️ 文件夹命名规则 项目名称和路径只能使用英文字母、数字和下划线。请勿使用中文、空格或特殊符号,否则会导致后续的代码编译失败!
- 正确示例:
my_awesome_game
- 错误示例:
我的超酷游戏
✅ 项目就绪
太棒了!你的第一个项目已经创建成功,并已在 VS Code 中打开。文件浏览器里会显示出标准的项目结构:
client/
- 存放客户端代码server/
- 存放服务端代码dao3.config.json
- 项目的配置文件- ... 其他配置文件
现在,你本地的“兵工厂”已经准备就绪。下一步,我们将把它与云端的“战场”连接起来。
重要:进入新项目文件夹
如果你刚刚通过输入新名称(如
my_first_game
)创建了项目,那么你当前的 VS Code 窗口仍停留在父级工作区。请务必手动打开刚刚创建的项目文件夹,以便后续的链接和编译操作能够正确执行。
- 在 VS Code 中选择
文件(File)
>打开文件夹(Open Folder)
,然后选中my_first_game
。
下一步的重要准备:你需要一张“扩展地图”
在我们将本地项目连接到云端之前,请确保你的神岛账号下至少拥有一张“扩展地图”。
ArenaPro 的所有强大功能(如代码上传、HMR 热更新、断点调试等)都必须在“扩展地图”中才能使用。
- 什么是扩展地图?它和普通地图有什么区别?
- 如果你还没有,请先前往神岛官网创建一个。
请继续阅读:第三步:连接云端。
上一篇:安装开发环境
下一篇:连接云端