第18章 Zed 快速上手指南:基本命令与 macOS 操作
Zed 是一款开源代码编辑器,内置协作与 AI 工具。
本指南涵盖基本命令、环境配置及导航操作。
快速上手
欢迎页
在未打开文件夹的情况下启动 Zed,主编辑区会显示欢迎页。该页面提供快速操作,用于打开文件夹、克隆仓库或查看文档。一旦打开文件夹或文件,欢迎页即会消失。若将编辑器分割为多个窗格,仅中心窗格为空时才会显示欢迎页,其余窗格显示标准空白状态。
若要重新打开欢迎页,可关闭中心窗格内的所有项,或通过命令面板搜索“Welcome”。
1. 打开项目
在命令行中打开文件夹:
zed ~/projects/my-app
或者在 Zed 内部使用 Cmd+O(macOS)/ Ctrl+O(Linux/Windows)打开文件夹。
默认情况下,新项目会在当前窗口的线程侧边栏中打开。若要在新窗口中打开,请使用 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. 配置编辑器
按 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)打开扩展页面 - 搜索你的语言
- 点击 Install(安装)
查看 语言支持 了解特定语言的具体配置说明。
5. 体验 AI 功能
Zed 内置了 AI 助手。按 Cmd+Shift+A(macOS)或 Ctrl+Shift+A(Linux/Windows)打开 Agent Panel 开始对话,或使用 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 或提出功能建议。
此部分为 JavaScript 代码,用于检测页面是否包含非 h1 级别的标题(以目录结构判断),并根据结果切换 class,以防止视觉闪烁。代码逻辑不翻译,保留原样。
(注:由于该片段几乎全部是 HTML/JS 代码块,根据“只翻译标签之间的文字”规则,仅翻译了唯一的注释行;JS 内部代码和所有标签、属性均原样保留。) 这段内容全是 JavaScript 代码和 HTML 注释,没有需要翻译的正文文字。代码本身必须原样保留,注释也属于代码的一部分,保持不变即可: