第16章 遥测（Telemetry）

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. 学习常用命令

命令面板（Cmd+Shift+P）是执行 Zed 中各类操作的入口。若遗忘快捷键，可直接在其中搜索。

面板布局

想让 Agent 面板和 Threads 侧边栏并排显示在左侧，可以从标题栏的用户菜单中选择 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 内置支持多种语言，其他语言则需要安装对应扩展：

1. 按 Cmd+Shift+X（macOS）或 Ctrl+Shift+X（Linux/Windows）打开扩展面板
2. 搜索你的语言
3. 点击 Install 安装

各语言的具体配置说明见 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 模式。
• Helix：在设置中启用 helix_mode。参见 Helix 模式。

加入社区

Zed 是开源项目。欢迎通过 GitHub 或 Discord 参与贡献代码、报告问题或提出功能建议。

• Discord
• GitHub Discussions
• Zed Reddit