# 用 VS Code 工作区高效开发你的项目

很多团队会同时维护多个地图项目、工具库与共享模块。与其在多个 VS Code 窗口来回切换，不如用“工作区（Workspace）”把它们**统一在一个窗口**里，获得一致的搜索、调试、任务与设置体验。

本篇将介绍如何在 ArenaPro 的场景下，创建并使用 VS Code 工作区来提升多项目协作效率。

## 我需要工作区吗？

- 你同时维护多个地图项目，并且它们之间存在共享代码或联调需求。
- 你有“本地私有包/工具库”（例如 `../my-utils`），需要与地图项目一起开发与联调。
- 你希望一次性搜索、格式化、运行任务，覆盖多个文件夹。

> 如果你正在使用 Monorepo（单仓多包），也非常建议配合工作区进行开发：工作区解决“编辑器侧的多根目录管理”，与包管理层（npm workspaces）相辅相成。

## 推荐目录结构（示例）

```
my-workbench/              # 工作台根目录（自定义名称）
  my-map/                  # 地图项目 A（ArenaPro 项目）
  my-map-2/                # 地图项目 B（可选）
  my-utils/                # 团队私有工具库（本地包）
  my-workbench.code-workspace  # 工作区配置文件（核心）
```

> 也可以将现有的多个项目分散在不同位置，只需在工作区中“添加文件夹”即可，并非强制同级。

## 创建工作区文件

1. 在 VS Code 中依次执行：

- 文件 → 将文件夹添加到工作区… → 依次选择 `my-map`、`my-utils` 等目录。
- 文件 → 另存为工作区… → 保存为 `my-workbench.code-workspace` 到便于访问的位置（建议放在公共父目录）。

2. 之后直接双击/打开该 `.code-workspace` 文件，即可一次性打开所有相关项目。

## 一键打开你的工作台

- 将 `my-workbench.code-workspace` 固定到你的 Dock/任务栏或 VS Code 的“最近打开”，实现一键进入多项目协作环境。
- 团队成员可共享该文件（注意路径差异），快速对齐开发环境与扩展。

---

通过 VS Code 工作区把相关项目整合在一个窗口中，你可以得到更顺畅的多项目协作体验：统一的搜索/格式化/任务视图，更清晰的调试切换，以及与本地私有包的无缝联动。建议将其与 npm workspaces 或 Monorepo 一同使用，覆盖编辑器和包管理两侧的协作需求。
