第4章 Zed 编辑器窗口与项目管理指南
Zed 支持在同一个窗口中处理多个项目。项目显示在左侧的 threads 侧边栏中，你可以在它们之间切换，同时保持上下文不变。
使用标题栏用户菜单中的 Panel Layout > Agentic（或 {#action workspace::UseAgenticLayout} action）可以让 Threads Sidebar 和 Agent Panel 一起停靠在左侧。使用 Panel Layout > Classic（或 {#action workspace::UseClassicLayout}）则可恢复以编辑器为主的布局。
项目如何打开
默认情况下，在 Zed 中打开一个文件夹时，它会作为新项目在当前窗口的 threads 侧边栏中打开，而不是新建窗口。这样可以把相关工作放在一起，并保留你的 agent threads 和布局。
| 操作 | 结果 |
|---|---|
| File > Open | 在当前窗口打开（threads 侧边栏） |
| File > Open Recent | 在当前窗口打开（threads 侧边栏） |
| 拖拽文件夹到 Zed | 在当前窗口打开（threads 侧边栏） |
zed ~/project |
在当前窗口打开（threads 侧边栏） |
多项目协作
当同时打开多个项目时：
- 点击项目标题可折叠或展开其 threads；Cmd+点击（macOS）或 Ctrl+点击（Linux/Windows）可切换到该项目
- 每个项目拥有独立的文件树、git 状态和搜索范围
- Agent threads 与其所属的项目上下文绑定
- 每个项目的工作区布局（分屏、标签页）会分别保留
可以把 threads 侧边栏中的项目理解成浏览器标签页，只不过管理的是代码仓库。
在新窗口中打开
有时你想要一个完全独立的窗口，方法如下：
通过 Open Recent
使用 File > Open Recent（{#kb projects::OpenRecent}）时：
- 回车或点击会在当前窗口打开（threads 侧边栏）
- Cmd+回车或 Cmd+点击（macOS）/ Ctrl+回车或 Ctrl+点击（Linux/Windows）会在新窗口打开
通过命令行
使用 -n 参数强制打开新窗口：
zed -n ~/projects/other-project
其他控制窗口行为的命令行参数：
| 参数 | 行为 |
|---|---|
-n, --new |
始终在新窗口中打开 |
-a, --add |
添加到当前窗口的线程侧边栏 |
-r, --reuse |
在现有窗口中替换当前项目 |
请参阅 CLI 参考文档 以获取完整细节。
通过设置修改
你可以使用 cli_default_open_behavior 设置来更改默认的 CLI 行为：
json [settings]
{
"cli_default_open_behavior": "new_window"
}
可选值：
existing_window（默认）：在当前窗口的线程侧边栏中打开文件夹new_window：在新窗口中打开文件夹
此设置影响 CLI 和双击行为，但不影响“文件 > 打开”菜单。
向项目添加文件夹
如果你想将文件夹添加到当前项目中（而不是作为线程侧边栏中的独立项目），有以下几种选项：
- 文件菜单：文件 > 将文件夹添加到项目
- 项目面板：在项目面板中右键点击，选择“将文件夹添加到项目”
- 最近打开：选择一个最近的项目，然后点击“将文件夹添加到该项目”按钮
这会将该文件夹作为当前项目文件树中的一个额外根目录添加，类似于 VS Code 的多根工作区。
另见
- 线程侧边栏：跨项目管理线程
- 快速入门：基本命令与配置
- 从 VS Code 迁移：Zed 的项目模型与 VS Code 有何不同
