第2章 Zed 编辑器入门：安装与快速上手指南
Zed 是一款开源代码编辑器，内置协作与 AI 工具。
本指南介绍核心命令、环境配置以及基础导航操作。
快速开始
欢迎页
不打开任何文件夹直接启动 Zed 时，主编辑区会显示欢迎页。欢迎页提供快捷操作，可以打开文件夹、克隆仓库或查看文档。一旦打开文件夹或文件，欢迎页就会消失。如果编辑器被拆分成多个面板，欢迎页只在中间面板为空时显示，其他面板则显示标准的空白状态。
要重新打开欢迎页，可以关闭中间面板中的所有标签页，或在命令面板中搜索 "Welcome"。
1. 打开项目
从命令行打开文件夹：
zed ~/projects/my-app
也可以在 Zed 中按 Cmd+O（macOS）或 Ctrl+O（Linux/Windows）打开文件夹。
默认情况下，新项目会在当前窗口的 threads 侧边栏中打开。如果想在新窗口中打开，可以使用 zed -n ~/projects/my-app，或在 "Open Recent" 列表中选择时按 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 Panel 和 Threads Sidebar 并排显示在左侧。使用 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 Panel 开始对话，或使用 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 参与代码贡献、报告问题或提出功能建议。