第15章 工作树信任 (Worktree Trust)
Zed 是一款内置协作与 AI 工具的开源代码编辑器。
本指南涵盖核心命令、环境配置及基础导航操作。
快速入门
欢迎页
在没有打开任何文件夹的情况下启动 Zed 时，主编辑区域会显示欢迎页。该页面提供快捷操作，包括打开文件夹、克隆仓库或查阅文档。一旦打开文件夹或文件，欢迎页即消失。若将编辑器分割为多个窗格，仅当中间窗格为空时才会显示欢迎页，其他窗格则显示标准空白状态。
如需重新打开欢迎页，可关闭中间窗格的所有内容，或通过命令面板搜索 “Welcome”。
1. 打开项目
通过命令行打开文件夹：
zed ~/projects/my-app
或在 Zed 内使用 Cmd+O（macOS）/ Ctrl+O（Linux/Windows）打开文件夹。
默认情况下，新项目会在当前窗口的 threads 侧边栏中打开。若需在新窗口中打开，请使用 zed -n ~/projects/my-app，或在选择“最近打开”时按下 Cmd+Enter。更多详情请参阅 窗口与项目。
2. 学习核心命令
| 操作 | macOS | Linux/Windows |
|---|---|---|
| 命令面板 | Cmd+Shift+P | Ctrl+Shift+P |
| 查找文件 | Cmd+P | Ctrl+P |
| 查找符号 | Cmd+Shift+O | Ctrl+Shift+O |
| 项目内搜索 | Cmd+Shift+F | Ctrl+Shift+F |
| 切换终端 | Ctrl+` | Ctrl+` |
| 打开设置 | Cmd+, | Ctrl+, |
命令面板（Cmd+Shift+P）是执行 Zed 中所有操作的入口。若忘记某个快捷键，可在此搜索。
面板布局
如果想把 Agent Panel 和 Threads Sidebar 并排放在左侧，可以在标题栏的用户菜单中选择 Panel Layout > Agentic（或使用 workspace: use agentic layout 命令）。选择 Panel Layout > Classic（或 workspace: use classic layout）可以恢复以编辑器为主的经典布局。
3. 配置编辑器
在 macOS 上按 Cmd+,（Linux/Windows 为 Ctrl+,）打开 Settings Editor，搜索任意设置项并直接修改。
常见的初始配置：
- 主题：按
Cmd+K Cmd+T（macOS）或Ctrl+K Ctrl+T（Linux/Windows）打开主题选择器 - 字体：在设置中搜索
buffer_font_family - 保存时格式化：搜索
format_on_save并设置为on
4. 配置语言支持
Zed 内置支持多种语言，其他语言需要安装对应的扩展：
- 按
Cmd+Shift+X（macOS）或Ctrl+Shift+X（Linux/Windows）打开扩展面板 - 搜索你需要的语言
- 点击 Install 安装
各语言的具体配置方法请参考 Languages 文档。
5. 体验 AI 功能
Zed 内置了 AI 助手。按 Cmd+Shift+A（macOS）或 Ctrl+Shift+A（Linux/Windows）打开 Agent Panel 开始对话，也可以按 Cmd+Enter（macOS）/ Ctrl+Enter（Linux/Windows）使用行内辅助功能。
如何配置 AI 服务商以及了解各项 AI 能力，请参考 AI Overview。
从其他编辑器迁移过来？
我们为常见编辑器的迁移提供了专门的指南：
- VS Code — 导入设置、映射快捷键、找到对应功能
- IntelliJ IDEA — 适应 Zed 的导航与重构方式
- PyCharm — 在 Zed 中搭建 Python 开发环境
- WebStorm — 配置 JavaScript/TypeScript 工作流
- RustRover — 在 Zed 中进行 Rust 开发
你还可以启用熟悉的快捷键方案：
- Vim：在设置中启用
vim_mode，详见 Vim Mode。 - Helix：在设置中启用
helix_mode，详见 Helix Mode。
加入社区
Zed 是开源项目。欢迎通过 GitHub 或 Discord 加入我们，参与代码贡献、报告 bug 或提出功能建议。