第21章 Zed 快速上手指南：核心命令与环境配置
Zed 是一款开源代码编辑器，内置协作与 AI 功能。
本指南介绍 Zed 的核心命令、环境配置及基本导航操作。
快速上手
欢迎页
在未打开任何文件夹时启动 Zed，主编辑区会显示欢迎页。欢迎页提供快速操作，可打开文件夹、克隆仓库或查看文档。一旦打开文件夹或文件，欢迎页随即消失。若将编辑器分屏为多个窗格，欢迎页仅在中间窗格处于空置状态时显示，其他窗格则展示标准的空状态。
如需重新打开欢迎页，可关闭中间窗格的所有项目，或使用命令面板搜索“Welcome”。
1. 打开项目
在命令行中打开文件夹：
zed ~/projects/my-app
或者在 Zed 内部使用快捷键 Cmd+O (macOS) / Ctrl+O (Linux/Windows) 打开文件夹。
默认情况下，新项目在当前窗口的线程侧边栏中打开。若需在新窗口中打开，可使用命令 zed -n ~/projects/my-app，或在“最近打开”列表中选择项目时按下 Cmd+Enter。更多详情请参阅 Windows & Projects。
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 所有功能入口的枢纽。若忘记某个快捷键，可在此处搜索。
面板布局
从标题栏的用户菜单中选择 Panel Layout > Agentic（或执行 workspace: use agentic layout 操作），可让 Agent 面板和 Threads 侧边栏并排显示在左侧。选择 Panel Layout > Classic（或执行 workspace: use classic layout）则恢复以编辑器为中心的布局。
3. 配置编辑器
按 Cmd+,（macOS）或 Ctrl+,（Linux/Windows）打开设置编辑器。搜索任意设置项并直接修改。
常见的初始设置如下：
- 主题：按
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）打开扩展面板 - 搜索目标语言
- 点击安装
语言特定的配置说明请参见 Languages。
5. 尝试 AI 功能
Zed 内置 AI 辅助功能。按 Cmd+Shift+A（macOS）或 Ctrl+Shift+A（Linux/Windows）打开 Agent 面板开始对话；使用 Cmd+Enter（macOS）/ Ctrl+Enter（Linux/Windows）可在当前行内获取建议。
配置 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 或提出功能建议。