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

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

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

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

1.  在你的电脑上，选择一个合适的位置（例如“文档”或 D 盘），创建一个新文件夹，用于存放神岛相关的所有代码项目。
2.  为它命名，例如 `ArenaPro_Projects` 或 `MyGames`。
3.  **在 VS Code 中打开这个文件夹**：
    - 启动 VS Code。
    - 通过顶部菜单栏 `文件(File)` > `打开文件夹(Open Folder)`，选中你刚刚创建的 `ArenaPro_Projects` 文件夹。

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

- **正确示例**：`my_awesome_game`
- **错误示例**：`我的超酷游戏`
  :::

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

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

1.  **启动项目向导**：

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

2.  **选择项目模板**：

    - 在弹出的选项中，我们按照向导给出的提示选择。
    - 如果过程中出现 `Ok to proceed? (y)` 的提问，**请输入 `y` 并按回车键** 以继续。
    - ![](/QQ20250709-180844.png)

3.  **确认存放位置并命名**：

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

:::warning window 环境常见问题

**你可能看到这样的错误：**

![脚本禁止执行](/QQ20251006-171924.png)

**简单解决方法：**

1. 右键点击开始菜单，选择"Windows PowerShell (管理员)"

   ![PowerShell 以管理员身份运行](/QQ20241204-212524.png)

2. 复制粘贴下面这行命令，然后按回车：

   ```bash
   Set-ExecutionPolicy RemoteSigned
   ```

3. 当看到提示时，输入 `Y` 并按回车

   ![更改执行策略](/QQ20241204-212656.png)

4. 关闭并重新打开 VS Code 即可，并重新创建神岛项目

:::

## ✅ 项目就绪

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

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

![标准的 ArenaPro 项目结构](/arenats.webp)

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

:::tip 下一步的重要准备：你需要一张“扩展地图”
在我们将本地项目连接到云端之前，请确保你的神岛账号下**至少拥有一张“扩展地图”**。

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

- **[什么是扩展地图？它和普通地图有什么区别？](/zh/authority/expandMap)**
- 如果你还没有，请先前往神岛官网创建一个。
  :::

请继续阅读：**[第三步：连接云端](./03-connect-to-cloud.md)**。
