如果你最近持续刷技术社区或 X大概率已经被 Zed 刷过屏了。这个由 Atom 原班核心团队打造、使用 Rust 语言实现的编辑器从开源第一天就以“启动速度极快、GPU 渲染、原生协作”三个标签吸引了大批开发者关注。我自己从第一次听说到真正把它用作日常主力编辑器前后大约两个月。中间踩过不少坑也研究过不少配置细节。这篇教程不追求堆砌术语而是把从下载安装、基本配置到高频功能、AI 接入和问题排查的完整过程整理出来给想从 VS Code 或其他编辑器切换过来、但不知道从哪下手的读者一份可以照做的参考。Zed 适合什么样的人如果你对编辑器启动速度敏感、喜欢 Vim 操作方式、希望一个工具里同时解决编辑、终端、协作和 AI 辅助Zed 大概率会让你舒服。如果你重度依赖某个 VS Code 专属插件或者常年远程开发那最好先看完第 6 章的踩坑清单再做决定。总之这篇文章不负责劝你卸载任何东西只负责把你需要知道的 Zed 点点滴滴讲清楚。1. 为什么是 Zed性能之外的四个理由1.1 从 Atom 团队到 Zed一脉相承的编辑器哲学要理解 Zed得先聊一段历史。Atom 是 GitHub 当年推出的编辑器曾经有一批忠实用户但后来被 VS Code 逐渐超越最终在 2022 年退役。Atom 的核心成员在项目结束后并没有放弃“做一个更好编辑器”的想法而是成立了公司从零开始打造 Zed。这件事的背景很有意思Atom 本身就是基于 Electron 的本质上是套了一个浏览器内核性能和内存占用始终被用户诟病。Zed 的诞生某种意义上就是这群人对自己以前技术路线的“清算”——他们决定不再依赖网页技术而是用 Rust 写一个真正的原生编辑器。这段历史决定了 Zed 的很多设计选择。它不是一个“改了个皮肤的 VS Code”而是从底层开始重新设计的作品。UI 层基于自研的 GPUI 框架纯 native 渲染不套浏览器不背一整个 Electron 的体积。了解这一点你就明白为什么 Zed 这么敢在性能上喊口号——那不是营销话术而是技术路线决定的必然结果。1.2 性能数字背后的底气Rust 和 GPU 渲染Zed 的启动速度有多快以我自己的实测在 macOS 上冷启动通常在 1 秒以内热启动基本是“点一下图标就出现窗口”的级别。相比 VS Code 平均 3~5 秒的启动时间这个差距在日常使用中非常明显。真正让 Zed 拉开差距的不只是启动速度还有滚动和编辑的顺滑度。它把整个编辑器界面理解为 GPU 可以绘制的图形光标移动、代码滚动、语法高亮都交给 GPU 管线处理而不是像传统编辑器那样在 CPU 上逐行计算布局。这一点在打开大文件、长代码行很多的项目时体验尤其明显。我用它打开过一个几万行的 Rust 工程光标在代码里上下移动依然流畅不会出现普通 Electron 编辑器那种“卡一下然后跳过去”的迟滞感。同时Zed 把很多操作设计成多线程并发执行比如文件索引和 LSP 语言服务器分析不会堵住 UI 线程。用聊天的方式解释VS Code 像是在浏览器里开了一个大型网页应用页面元素越多越容易卡Zed 则像是一个精心优化的游戏客户端界面上每帧元素都是 GPU 直接绘制性能自然不在一个量级。1.3 协作、AI 与编辑深度整合的产品观Zed 不只是把编辑器本身做快了它还在产品理念上赌了一条“未来开发环境”的路。Zed 内置了名为 Channel 的协作功能你可以创建频道、邀请队友加入大家在同一份代码上实时看到彼此的光标甚至可以语音沟通。这比“远程共享屏幕”或者“开一个会议然后各自改代码”的体验好得多。这个功能不是插件商店里的某个扩展而是编辑器主体的一部分所以协作的延迟控制和稳定性都更有保障。AI 也是同样的思路。Zed 没有走“插件市场里装一个 AI 助手”的路线而是把 AI 面板、内联补全和代码重构指令直接做进编辑器核心。实际使用下来这种“原生集成”的好处是 AI 可以更自然地读取当前文件、当前选中内容甚至整个工作区上下文不需要像 VS Code 扩展那样做一堆剪贴板交互。Zed 的产品观很清晰编辑器是开发环境的中枢协作和 AI 不是外挂而是这个中枢的原生能力。1.4 和 VS Code、Cursor 相比的真实差距当然Zed 也不是没有短板。最直观的一点是插件生态和 VS Code 还不在一个量级。VS Code 的扩展市场里有几万个插件几乎什么冷门语言、工具链都有对应的支持Zed 的扩展中心目前还是以主题和语言包为主深度定制类的扩展正在发展但尚未完全成熟。Cursor 是另一条路线它基于 VS Code 的生态把 AI 能力深度封装进编辑器比如 Chat、Composer、代码库索引等。Zed 的 AI 是原生自研的但目前的丰富度对比 Cursor 还有距离两者解决的问题侧重点不同。我的建议是判断自己该不该用 Zed核心就看两点——第一你是否依赖“非 VS Code 不可”的插件第二你是否需要成熟的远程开发方案。如果这两个问题的答案都是“否”Zed 能给你带来的速度和集成体验非常值得一试。2. 从下载到跑起来三个平台的安装实操2.1 macOS命令行一行搞定macOS 上安装 Zed 最方便的方式是使用 Homebrewbrew install --cask zed如果你没有安装 Homebrew去官网下载 dmg 文件直接拖进 Applications 目录也是一样的效果。第一次启动时会弹提示问是否安装zed命令行工具建议选“是”这样后续在终端里就能随时用zed .打开当前目录或者zed README.md打开指定文件。安装完成后建议先把命令行别名确认一下。在终端执行which zed如果输出/Applications/Zed.app/Contents/MacOS/zed或类似路径说明安装成功。接下来直接zed .打开一个已有项目即可。首次打开项目时Zed 会做索引后台会自动下载当前语言需要的 LSP 语言服务器。这个步骤需要联网如果你的网络环境受限之后打开文件可能没有代码提示后面我会专门讲这个的排查。2.2 Windows安装包和 winget 两种方式Zed 对 Windows 的支持最近已经比较成熟官方提供了安装包也支持 winget 命令行安装winget install Zed.Zed不想用命令行的话去 GitHub 的 Releases 页面下载 exe 安装程序双击安装就行。安装过程中没太多需要自定义的选项一路下一步即可。装完第一次启动后同样建议在命令面板里确认是否安装命令行工具Windows 上一般会自动处理好 PATH。有一点需要提醒 Windows 用户Zed 的 daily 版本更新非常频繁功能迭代快但偶尔也会引入一些小的不稳定问题。如果不是为了体验最新特性建议用稳定版Stable而不是 daily 版。我自己在 Windows 上主要做 TypeScript 开发日常使用的是稳定版体验已经足够顺滑。2.3 Linux脚本安装与 AppImageLinux 上的官方安装方式是一行脚本curl -f https://zed.dev/install.sh | sh这个脚本默认会把 Zed 安装到~/.local/bin并自动添加 PATH。如果你的发行版没有把~/.local/bin加入 PATH需要手动在~/.bashrc或~/.zshrc中加一行export PATH$HOME/.local/bin:$PATH如果脚本下载失败或者网络太慢可以去 GitHub Releases 下载 AppImage 文件但使用 AppImage 需要系统装有 FUSE 运行库。Ubuntu 等常见桌面发行版一般自带但精简版的 WSL 或者某些无桌面环境服务器可能没有装。如果运行时报fuse: device not found之类的错误先通过发行版包管理器安装 FUSE 再试。2.4 安装后的第一件事确认 LSP 是否正常拉取刚装完 Zed 后我希望你先别急着配置主题先花两分钟做一次“健康检查”。任选一个项目目录用zed .打开然后打开一个 Python、TypeScript 或 Rust 文件观察编辑器的状态。如果代码有语法高亮、有智能提示、有错误提示说明 LSP 已经正常工作。这是判断 Zed 是否完全可用的关键一步因为 Zed 的很多智能功能都依赖 LSP。如果打开文件后发现没有任何提示大概率是 LSP 下载失败或网络拦截。Zed 会在后台下载对应语言的 Language Server比如 Python 的 Pyright、TypeScript 的 typescript-language-server、Rust 的 rust-analyzer。你可以打开命令面板输入language server之类的关键词查看当前文件对应的语言服务器状态。如果确实没起来先检查网络再考虑手动安装对应的独立 LSP 工具。很多语言服务器本身就是独立的可执行程序Zed 也会尝试优先使用系统已有的。3. 第一份 settings.json把编辑器调成自己的形状3.1 配置文件在哪里为什么用 JSONZed 的配置方式非常“程序员化”不是一堆图形化勾选框而是一个 JSON 文件。这样做的好处有两个一是配置即代码你可以把配置放进自己的 dotfiles 仓库换电脑或者重装系统后一键恢复二是 Zed 的配置项非常多且细JSON 格式表达起来更简洁直接。配置文件的位置macOS 和 Linux~/.config/zed/settings.jsonWindows%APPDATA%\Zed\settings.json如果你找不到这个文件不用慌——首次安装后它不一定存在。按CmdShiftPWindows 是CtrlShiftP打开命令面板输入zed: open settingsZed 会帮你创建好目录和文件并打开编辑器。配置文件保存后立即生效不需要重启编辑器这一点比改完配置还要重启大半天的某些 IDE 舒服太多。3.2 主题、字体、行号和自动保存先合眼缘以下是一份我目前在所有机器上都会使用的基础配置不算花哨但非常实用{ theme: One Dark, ui_font_size: 14, buffer_font_family: JetBrains Mono, buffer_font_size: 13, tab_size: 2, relative_line_numbers: true, autosave: on_focus_change }逐个说明一下我为什么这么配themeZed 默认内置了多款主题One Dark、Gruvbox Dark、Solarized 等都有。如果你喜欢更现代的风格可以去扩展中心搜更多主题。主题可以在命令面板里输入theme selector快速切换试了一圈之后再把最终喜欢的写进 JSON。buffer_font_family代码字体。我用 JetBrains Mono 很久了宽窄均匀、区别度高。如果你的系统装了 Fira CodeZed 支持连字Ligature显示可以在配置里开启相关字体特性。relative_line_numbers相对行号。配合 Vim 模式和命令跳转很实用让我能不依赖行号插件更快定位上下文。autosave我选的是on_focus_change意思是当编辑器窗口失去焦点时自动保存。这样我切换到浏览器或终端的时候代码已经保存好了不担心忘记保存。3.3 开启 Vim 模式一个决定性的配置如果你习惯 Vim 的键位这一项绝对是 Zed 最酥服的体验之一。在 settings.json 里加一行vim_mode: true保存后Zed 立刻变成 Vim 风格h/j/k/l移动、dd删除、ciw改词、u撤销、Ctrl[回到普通模式这些操作全都原生支持。关键和 VS Code 里装 Vim 插件不一样的是Zed 的模式逻辑是在编辑核心层面实现的不是模拟按键所以在普通模式、插入模式、可视模式之间切换没有任何延迟感也不会出现插件被某些弹窗吃键位之类的烦人问题。开启 Vim 模式后Zed 原有的快捷键仍然可用比如CmdShiftP打开命令面板CmdP切换文件。你可以在普通模式下顺手执行编辑器功能不用像某些编辑器那样还得先把 Vim 插件禁用才能用原生快捷键。如果你是从 Neovim 切过来的建议再加一条vim_use_system_clipboard: true这样删除、复制的内容直接进系统剪贴板和终端里复制粘贴互不冲突。3.4 针对不同语言配置 LSP 和格式化工具Zed 对每种语言都会给出默认的 LSP 和格式化方案但如果你想自定义可以在配置里加一个languages字段。举个例子{ languages: { Python: { language_servers: [pyright, ruff], formatter: ruff format }, TypeScript: { language_servers: [typescript-language-server], formatter: prettier } } }这个配置的含义是编辑 Python 文件时Zed 会同时用 Pyright 做类型检查和补全、用 Ruff 做 lint 检查并用 Ruff 来格式化代码编辑 TypeScript 时则使用 typescript-language-server 和 Prettier。这些工具如果系统已经装好了Zed 会直接调用如果没有Zed 会尝试自动安装。这个自定义能力解决了很多开发者的核心痛点不同团队、不同项目往往有自己固定的 lint 和 format 工具Zed 能够尊重项目内的约定。4. 高频功能实测从模糊搜索到多光标编辑4.1 命令面板与文件切换器键盘驱动的核心Zed 的日常工作流高度依赖键盘。我每天最常按的几个组合键如下功能macOSWindows / Linux打开命令面板CmdShiftPCtrlShiftP文件切换器模糊搜索CmdPCtrlP全局搜索CmdShiftFCtrlShiftF切换文件树CmdShiftECtrlShiftE选中下一个相同词CmdDCtrlD添加多光标鼠标Alt点击Alt点击文件切换器是我个人感知最强的一个功能。VS Code 的 CtrlP 已经很好了但 Zed 给我的感觉是结果出现得更快而且搜索排序更贴合我的使用习惯。你还可以在文件切换器里输入:行号直接跳转比如输入app.ts:120会直接打开 app.ts 并定位到第 120 行。全局搜索同样很快几万行代码的项目搜索关键词结果几乎是秒出的。日常开发中“切换文件 全局搜索 命令面板”三件套占了我 80% 的导航操作Zed 这三件套的响应速度确实让人心情愉悦。4.2 多光标和批量修改高频编辑场景不拖后腿批量修改代码是编辑器使用频率最高的操作之一。Zed 的多光标功能非常顺滑按住Alt再点击鼠标可以在多个位置放置光标随后同时输入。选中一个词后按CmdD会选中下一个相同词继续按直到覆盖你要修改的所有位置。使用CmdShiftL可以一次性选中当前文件中所有和选中内容一致的片段。这几种操作结合起来重构一个重复出现的函数名、批量给一组变量加上前缀、同时修改多处类似的错误效率提升非常明显。再加上第 3 章提到的 Vim 模式你可以用.命令重复上次修改这让很多重复性操作几乎可以盲操作。在我个人的体验里Zed 的多光标和批量修改响应速度比 VS Code 要快一档尤其是在大文件里快速选中多处相同内容时没有明显的卡顿或延迟。4.3 内置终端与任务系统少切换窗口就是少打断开发过程中最打断思路的事情就是在编辑器和终端之间来回切换。Zed 内置的终端面板虽然不算惊艳但胜在跟编辑器“同一个进程”你可以在终端里敲命令、看构建日志、跑测试不用离开编辑器窗口。终端支持多开每个终端有独立的标签终端的字体和背景默认跟随 UI 主题不会显得突兀。任务系统Tasks是比终端更进一步的集成。你可以在项目根目录创建.zed/tasks.json文件定义一组常用任务[ { label: run dev server, command: npm run dev }, { label: run tests, command: cargo test, tags: [cargo] } ]然后在命令面板里输入task关键词就能看到并运行这些任务。任务的输出会显示在单独的 Task 面板中和交互式终端分开。这样构建日志和手动敲的命令各自有各自的面板不用在一个终端窗口里翻来翻去找上一次的报错在哪。对 Rust 项目尤其舒服cargo test和cargo run分别配成一个任务平时切换运行目标只需要调命令面板。4.4 扩展中心目前的真实情况能装什么、什么还不能装在下载任何编辑器之前你最担心的往往是“我需要的插件有没有”。Zed 的扩展中心用命令面板输入zed: extensions或zed: install extension打开。目前质量较高的扩展主要围绕两类主题和语言包。比如更丰富的代码高亮、额外的 LSP 配置、各种配色主题等。至于更复杂的扩展比如 GitKraken 风格的图形化 Git 工具、自定义侧边栏组件、特定的代码片段库插件等目前还比较有限。好消息是 Zed 内置了很多功能比如 Git 面板、文件树、终端的 diff 视图这些在 VS Code 里往往需要组合多个插件才比较好用Zed 直接给做进了主体。如果你用的语言和工具链足够主流Zed 开箱即用的体验其实已经很好但如果你是那种“没有 XX 插件就不会写代码”的选手建议先查一下你要的插件有没有对应的 Zed 扩展或者替代方案再考虑迁移。5. AI 功能接入指南从云模型到本地模型5.1 内置 AI 面板聊代码、改代码、解释代码Zed 的 AI 功能天然内置没有插件安装的步骤。在命令面板输入assistant: new thread可以打开一个 AI 对话面板之后你可以选中一段代码直接问“这段代码有什么问题”“帮我把这段函数改成异步风格”“解释一下这个循环的作用”之类的自然语言指令。AI 会结合当前文件甚至工作区的上下文来回答这是它比在浏览器里开 ChatGPT 粘代码更顺手的地方。AI 能力大致分三层内联补全编辑时给出灰色建议按 Tab 接受。聊天式问答AI 面板中和代码上下文对话。内联编辑指令在代码区域直接用自然语言发出修改指令AI 会自动生成 diff。这些功能需要用 Zed 账号登录或者配置自己的模型服务才能用。Zed 官方提供的托管 AI 服务很方便但它更偏向“开箱即用订阅制”如果你是国内网络环境或者想省钱、重视数据隐私更推荐自己配置一个 OpenAI 兼容接口。5.2 配置 OpenAI 兼容模型的思路Zed 的 AI 功能支持 OpenAI 兼容协议因此“任何提供 OpenAI 风格 API 的服务”理论上都可以接。常见的开源模型网关One API、New API、云厂商提供的兼容端点、本地推理框架Ollama、LM Studio、vLLM都可以通过这个思路接入。在 settings.json 里大致这样配置{ assistant: { enabled: true, provider: openai, openai: { base_url: https://your-endpoint.example.com/v1, api_url: https://your-endpoint.example.com/v1, model: your-model-name, api_key: your-api-key } } }这里的base_url和api_url指向 OpenAI 兼容接口的地址model换成你实际要用的模型名api_key填对应的密钥。有的版本只需要填base_url和api_key就能工作多余字段写上也无妨。需要注意的一点是Zed 的 AI 配置字段在不同版本迭代较快如果你在编辑 settings.json 时看到字段名被划横线或者提示不存在以当前版本编辑器内提示为准。5.3 把本地 Ollama 模型接进 Zed免费方案的实操路径对于大多数人来说“免费使用 AI”是最关心的需求。你的机器上跑一个 Ollama然后让 Zed 指向本地服务的 OpenAI 兼容端口整个过程不需要花一分钱。第一步确认 Ollama 已经装好并且拉取了对应模型。以我用的qwen2.5-coder:7b为例ollama serve ollama pull qwen2.5-coder:7b第二步确认 Ollama 的 OpenAI 兼容接口可用。默认情况下Ollama 会在http://127.0.0.1:11434/v1地址提供 OpenAI 风格的 API。设置好环境变量或者直接写进 Zed 配置{ assistant: { enabled: true, provider: openai, openai: { base_url: http://127.0.0.1:11434/v1, api_url: http://127.0.0.1:11434/v1, model: qwen2.5-coder:7b, api_key: ollama } } }第三步重启 Zed 或重新打开 AI 面板测试对话是否响应。如果配置正确AI 面板会走本地模型速度取决于你 CPU/GPU 的性能。我实测下来7B 级别的量化模型在 M1 Pro 上用 GPU 加速跑内联补全的速度基本跟得上打字节奏。如果你希望内联补全也能生效可能还需要查看当前版本是否有额外的开关比如show_inline_completions: true总而言之把任何本地推理框架当作 OpenAI 兼容服务暴露出来再指给 Zed是一种通用的有效方案。如果你想换更大模型比如 13B 或 32B只要你的显存管够把model名字换掉就行。5.4 关于 AI 配置的实操提醒免费方案和云方案在使用体验上有明显差异。本地 7B 模型做简单的解释、补全绰绰有余但回答复杂架构问题时会显得“不太聪明”。我的建议是把本地模型用于内联补全和简单问答遇到复杂问题再切到云端的强模型。双模型并行不一定需要 AI 功能本身支持你完全可以多配一个 provider 或在不同对话中切换不同模型。另外一个实际的使用经验在 AI 面板提问时尽量选中相关代码块再问。不要让它基于一大坨不相关的文件内容生成回答否则噪音会很大回答质量明显下降。代码补全也一样如果你的工作区非常庞大且复杂Zed 会在后台读取大量上下文本地小模型的处理时间会变长这时候缩小工作区范围或者把模型 context 长度调小响应速度会明显改善。6. 踩坑清单安装和使用中我遇到的真问题6.1 Linux 下启动失败多半是 GPU 驱动和 Vulkan 的事Zed 在 Linux 上最让人头疼的一点是依赖 GPU 渲染而 Linux 的图形栈恰恰是最容易出幺蛾子的。常见的报错包括启动后窗口空白、闪退或者终端提示找不到 Vulkan 相关的动态库。我的排查顺序是确认显卡驱动是否安装完整。NVIDIA 用户检查nvidia-smi是否正常输出Intel/AMD 核显或入门显卡确认 mesa 和 vulkan 相关包是否已安装。如果启动即闪退或黑屏先尝试软件渲染方式启动LIBGL_ALWAYS_SOFTWARE1 zed或者根据报错提示设置其他环境变量。软件渲染能启动说明问题大概率在 GPU 驱动上而不是 Zed 本身。 3. 如果用的是精简版桌面环境缺少一些图形库也会导致类似问题。这时候用发行版的包管理器补装基础图形库比如mesa-utils、libvulkan1等是最稳妥的。Zed 官方对 Linux 的支持还在不断打磨中但最近几个版本已经明显稳定了。如果不想折腾驱动推荐优先考虑 Ubuntu 系的发行版图形栈问题相对少。6.2 中文输入法失效Wayland 下的一条典型处理路径这是 Linux 用户高频踩坑点在 Zed 里按英文键没问题切到中文输入法后啥都打不出来。根源在于 Zed 的 GPUI 自绘界面和输入法框架尤其 fcitx5之间的适配在 Wayland 下还不够完美。我实测比较有效的方案确认 fcitx5 的 Wayland 支持是好的。重新加载输入法fcitx5 -r检查环境变量GTK_IM_MODULE、QT_IM_MODULE、XMODIFIERS是否指向 fcitx必要时在启动 Zed 前手动设置。如果仍然不行尝试让 Zed 以 X11 模式运行比如在 Wayland 会话里借助 XWayland 运行 Zed。虽然这绕了一圈但很多情况下输入法立刻恢复正常。macOS 上我用原生中文输入法没有任何问题Windows 上 Win10/11 自带的微软拼音在 Zed 里也一切正常。中文输入法的问题主要还是集中在 Linux特别是新版本刚发布时偶尔出现回归建议关注 Zed 的 Release Notes。6.3 远程开发Zed 目前最明显的一块短板VS Code 用户最习以为常的 Remote-SSH、Dev Containers 这类远程开发工作流Zed 目前的官方支持比较弱。我在服务器上做 Go 开发时曾经想全程用 Zed但最后还是回到 VS Code 处理远程场景。社区有一些第三方方案比如类似 remote Zed 的实现但整体成熟度、稳定性和 VS Code 的 Remote-SSH 差距不小。如果你和我一样平时 80% 时间在本机开发只是偶尔去远程服务器看一个文件、跑一个脚本那完全可以用 Zed 应付。但如果是常年远程开发最好还是别强求甚至不用急着切换。Zed 官方已经把这个列为重点发展方向我相信以后会越来越好但目前不要因此影响生产力和心情。6.4 一组零碎的日常使用心得最后分享一些零碎但很实用的经验大项目首开时 Zed 会做文件索引大多数时候很快但如果你用的是互联网磁盘或老式机械硬盘索引期间可能会有一点资源占用耐心等一下就好。不要在同一台机器上同时装 Stable 和 Daily 版并反复切换配置两个版本的配置格式偶尔不兼容容易出现“上次能用这次不能”的怪问题。自动保存建议开着用on_focus_change是既不打扰、又能兜底的好选择。Zed 的 Git 面板内置的 diff 视图很好用支持暂存、丢弃和逐行操作不再需要单独打开一个 Git GUI。遇到配置项拿不准的时候直接打开zed: open settings编辑器内会有字段提示和默认值参考比去翻文档更快。按我个人现在的使用习惯日常本机开发主力已经变成了 Zed特别是 Rust、TypeScript、Python 这些语言的项目启动快、Vim 模式顺手、AI 辅助也不拖后腿。遇到需要远程调试或者重度依赖 VS Code 插件的地方我很自然地切回 VS Code。工具是服务于工作的给自己设一个“只用一把锤子”的执念没有必要。希望这篇保姆级教程能帮你顺利把 Zed 跑起来少踩一些我已经替你踩过的坑。