企业官网建设流程全解析

Zed 扩展系统指南：安装、开发、发布全流程一次搞定

【免费下载链接】zedCode at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.项目地址: https://gitcode.com/GitHub_Trending/ze/zed

先问一句：你的编辑器能不能自己“长出新功能”？写一种新语言时希望打开就有高亮，受不了一直默认配色时想一键换外观——这些需求不必等官方更新。Zed 扩展系统让 Zed 编辑器不碰源码就能装入新能力：语言支持、主题、图标、调试器、代码片段……本文带你走通“装一个来用”到“做一个并公布出去”的完整流程。

Zed 扩展能力全景

一句话说清：一个扩展就是一个带extension.toml清单的 Git 仓库，往里放不同的文件，编辑器就能“长出”不同能力：

官方维护的扩展就在本仓库 extensions/ 目录，HTML、GLSL、Proto 等语言都是这样实现的，和社区的扩展使用同一套扩展 API。

先对号入座：两类读者，两条路

一个判断句就分流：你是想用现成的功能，还是想造一个还不存在的功能？

• 只想用 → 往下看 Zed 扩展安装
• 想自己造 → 直接跳到 扩展开发五步走

只想用：Zed 扩展安装的三种方式

商店安装只需三步：打开扩展商店 → 搜索扩展名 → 点安装。装完的扩展源码放在系统扩展目录（Linux 上是~/.local/share/zed/extensions），其中work子目录存放扩展运行时产生的文件，比如下载下来的语言服务器。

如果你装了 dev 扩展，覆盖了已发布的同名版本，扩展页面会显示 “Overridden by dev extension”，属正常现象。

想自己造：从 0 到 1 交付一个 Zed 扩展的五步

1. 环境准备

只需要 Rust 和 Git。注意 Rust 要通过 rustup 安装：Zed 用wasm32-wasip2这个 WebAssembly 目标（可以理解为把扩展代码编译成一段编辑器沙箱里运行的通用字节码）编译扩展，rustup 会帮你自动装好目标；其他安装方式需要自行添加。带语法的扩展还依赖 wasi-sdk 来编译 Tree-sitter 解析器，Zed 会自动下载。

2. 目录骨架

my-extension/ extension.toml # 必填，扩展清单 Cargo.toml # 有自定义 Rust 代码时才需要 src/ lib.rs languages/ # 可选，语言支持 my-language/ config.toml highlights.scm themes/ # 可选 my-theme.json

别被目录吓到——真正必填的只有extension.toml，纯主题扩展一行 Rust 都不用写。

3. 写元数据

extension.toml内容如下：

id = "my-extension" name = "My extension" version = "0.0.1" schema_version = 1 authors = ["Your Name <you@example.com>"] description = "A sample extension" repository = "https://gitcode.com/GitHub_Trending/ze/zed"

4. 写核心代码

需要自定义逻辑（语言服务器、调试器、MCP 服务器等）时，补上Cargo.toml：

[package] name = "my-extension" edition = "2021" [lib] crate-type = ["cdylib"] [dependencies] zed_extension_api = "0.1.0"

src/lib.rs有固定模板：定义结构体、实现Extensiontrait、用宏注册：

use zed_extension_api as zed; struct MyExtension; impl zed::Extension for MyExtension { // 按需实现方法 } zed::register_extension!(MyExtension);

⚠️ 一个易踩的坑：扩展跑在 WebAssembly 沙箱里，cfg指令、std::env::var等常规 Rust 写法不按预期工作。环境信息改用current_platform()，读环境变量、在用户PATH里找二进制改用Worktree结构体。

5. 本地调试

不用发布就能在 Zed 里用：扩展页点Install Dev Extension，选中你的扩展目录。看日志用println!/dbg!，然后从终端zed --foreground启动 Zed，INFO 级输出会直接打在终端里；也可以用Open Log命令查看 Zed.log。

进阶能力：最常见的三类扩展怎么做

语言扩展：让 Zed 看懂一门新语言

languages/下放语法配置与.scm查询文件搞定高亮、括号、缩进；在extension.toml里注册语言服务器后，补全和格式化也齐了。参考 docs/src/extensions/languages.md。

主题扩展：把编辑器换成你的口味

主题就是一组 JSON 颜色定义，纯配置零代码，最适合新手第一个练手项目。参考 docs/src/extensions/themes.md。

MCP 服务器：给 AI 加私有能力

扩展提供的 Slash 命令已被官方移除，现在要给 Agent 面板加自定义工具和上下文，标准做法是写 MCP 服务器扩展。参考 docs/src/extensions/mcp-extensions.md。

扩展发布 Checklist

发布前逐项打勾：

• 扩展仓库是公开的 Git 仓库，且有extension.toml
• 附带了被接受的开源许可证（Apache 2.0、MIT、BSD 3-Clause、GPLv3 等）
• 本地 dev 扩展已跑通，元数据字段完整
• 一个 PR 只新增或更新一个扩展，同一账号最多 3 个 open PR
• 能在 3 周内响应维护者反馈，否则 PR 会被关闭

提交流程：fork 官方扩展注册表仓库并克隆，git submodule init+git submodule update→ 把你的扩展以子模块（必须 HTTPS 地址）加到extensions/{extension-id}路径 → 在顶层extensions.toml添加条目，版本号与extension.toml一致 → 运行pnpm sort-extensions排序 → 提 PR。合并后扩展即打包上架。详见 docs/src/extensions/publishing/overview.md。

避坑提速：常见问题速查

现在就可以动手

挑一个你天天用、Zed 却高亮不好的语言，就是你的第一个扩展。核心资源都在仓库里：

• 扩展系统总览：docs/src/extensions.md
• 开发指南：docs/src/extensions/developing-extensions.md
• 发布指南：docs/src/extensions/publishing/publishing-guide.md
• 官方扩展示例：extensions/
• 扩展 API 源码：crates/extension_api/

【免费下载链接】zedCode at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.项目地址: https://gitcode.com/GitHub_Trending/ze/zed