第1章 Zed 快速入门
Zed 是一款开源代码编辑器，内置协作和 AI 工具。
本指南涵盖核心命令、环境配置和基础导航。
快速入门
欢迎页
在 Zed 中未打开任何文件夹时，主编辑区会显示欢迎页。该页面提供快捷操作，如打开文件夹、克隆代码仓库或查看文档。一旦打开了某个文件夹或文件，欢迎页便会消失。若将编辑器分屏为多个窗格，欢迎页仅在居中空窗格中显示，其他窗格则显示标准的空状态。
若要重新显示欢迎页，需关闭中间窗格的所有内容，或在命令面板中搜索“Welcome”。
1. 打开项目
通过命令行打开文件夹：
zed ~/projects/my-app
或使用 Cmd+O（macOS）/ Ctrl+O（Linux/Windows）在 Zed 内部打开文件夹。
默认情况下，新项目会在当前窗口的 threads 侧边栏中打开。若要在新窗口中打开，请使用 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”（或执行 {#action workspace::UseAgenticLayout} 操作），即可让 Agent 面板和 Threads 侧边栏并排显示在左侧。若需恢复以编辑器为主的布局，请选择“Panel Layout > Classic”（或执行 {#action workspace::UseClassicLayout} 操作）。
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）打开扩展中心 - 搜索所需语言
- 点击“安装”
请参阅语言指南，了解特定语言的配置说明。
5. 体验 AI 功能
Zed 内置了 AI 辅助功能。按 Cmd+Shift+A（macOS）或 Ctrl+Shift+A（Linux/Windows）打开 Agent 面板开始对话，或使用 Cmd+Enter（macOS）/ Ctrl+Enter（Linux/Windows）获取行内辅助。
请参阅AI 概述，以配置服务提供方并了解其功能。
从其他编辑器转来？
我们提供了从其他编辑器迁移的专项指南：
- 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 或提出功能建议。
