Important
Remove this line to confirm you've reviewed this PR before submitting.
本仓库是 Zed 的简体中文汉化分支,在保持与上游同步的基础上,提供完整的中文界面翻译。
Zed 是一款高性能、多人协作代码编辑器,由 Atom 和 Tree-sitter 的创建者开发。
汉化通过 crates/zed_i18n 实现,当前已翻译 70 个模块的界面文本,涵盖:
- 编辑器核心 UI(命令面板、文件查找、诊断、项目面板、搜索、大纲、终端等)
- AI / Agent 面板(agent_ui、ai_onboarding 等)
- 调试器界面(debugger_ui、debugger_tools)
- Git 相关(git_ui、collab_ui)
- 文档与媒体预览(markdown_preview、image_viewer、office_preview、csv_preview、svg_preview)
- 设置与选择器面板(settings_ui、keymap_editor、主题/语言/编码选择器等)
- 扩展管理、反馈、自动更新等
在 Zed 设置中添加:
{
"ui_language": "zh-CN"
}即可切换为中文界面。设为 "en" 或不配置则使用英文。
crates/zed_i18n/locales/
├── en/ # 英文(上游原始文本)
├── zh-CN/ # 简体中文翻译(70 个 .toml 文件)
├── en.toml
└── zh-CN.toml
每个 crate 对应一个 <crate_name>.zh-CN.toml 文件,通过 t! 宏在运行时按 key 查找译文。
- 在
crates/zed_i18n/locales/zh-CN/下找到对应模块的.toml文件 - 补全或修正翻译 key
- 确保与
en/目录下的 key 保持一一对应 - 提交 PR 到本仓库
- i18n 体系:通过
crates/zed_i18n为 70 个模块实现运行时语言切换(ui_language:zh-CN/en)。 - tabular_data_preview:表格与 SQLite/CSV 预览的内联设置面板,挂载在上游
TableView上。 - fs_watcher 健康检查:
check_watch_health+watched_paths,watch 丢失时自动重扫。 - Agent / Agent UI:保留并强化 fork 特性,包括可恢复消息、混淆字符扫揃(请求与解析后路径同时检查)、markdown 内联图表缓存等。
- CI / 发布:精简
run_tests.yml+release.yml(三平台未签名包自动发布);run_tests改为手动触发;check_style增加汉化键完整性检查(scripts/i18n/check-missing-keys.py)。三个平台各自输出原生安装包:Linux 为.deb(另附 tar.gz),Windows 为.exe安装器,macOS 为.dmg。 - 版本号:不落后于上游最新正式 release,由
scripts/sync-upstream-version.py指定、同步与校验;release.yml校验Cargo.toml/Cargo.lock一致及版本下限,标签与Cargo.toml不一致则拒绝发布。 - 分支策略:
main为稳定发布分支(当前v1.29.1),功能开发在develop分支进行并 PR 合并至main。
macOS、Linux 和 Windows 可直接下载 Zed,或通过包管理器安装(macOS/Linux/Windows)。
本汉化版提供 GitHub Releases 三平台未签名包:Releases 页面;或按下方开发指南自行从源码构建。
| 系统 | 安装包 | 安装方式 |
|---|---|---|
| Ubuntu / Debian | zed-zh-cn_<版本>_amd64.deb |
sudo apt install ./zed-zh-cn_<版本>_amd64.deb |
| Windows | Zed-x86_64.exe |
运行安装器(未签名,可能出现 SmartScreen 提示) |
| macOS(Apple Silicon) | Zed-aarch64.dmg |
打开镜像并拖入 Applications |
| 其他 Linux | zed-linux-x86_64.tar.gz |
解压后运行 bin/zed |
其他平台暂不可用:
- Web(跟踪讨论)
参见 CONTRIBUTING.md 了解贡献方式。
汉化相关贡献请直接提交 PR 至本仓库(ReachForStar/zed-ZH_CN)。
Zed 源代码主要采用 GPL-3.0-or-later 许可,标注部分采用 Apache-2.0。
第三方依赖的许可信息必须正确提供以通过 CI。
我们使用 cargo-about 自动合规开源许可。如果 CI 失败,检查以下情况:
- 你创建的 crate 报
no license specified?在 Cargo.toml 的[package]下添加publish = false。 - 依赖报
failed to satisfy license requirements?确认该项目的许可证及合规方式,然后将 SPDX 标识符添加到script/licenses/zed-licenses.toml的accepted数组。 cargo-about找不到依赖的许可证?在script/licenses/zed-licenses.toml末尾添加 clarification 字段,参见 cargo-about 文档。
Zed 由 Zed Industries, Inc. 开发。如希望支持上游项目,可通过其 GitHub Sponsors 赞助,资金直接进入 Zed Industries,不附带任何特权。
本汉化版由 ReachForStar 独立维护,与 Zed Industries 无隶属关系。如果你认可这份本地化工作,欢迎扫码支持本仓库的持续维护:
| 微信支付 | 支付宝 |
|---|---|
![]() |
![]() |
中文 Zed 汉化、Zed 汉化版、Zed 中文、Zed 中文版、Zed 简体中文、Zed 中文设置、Zed 中文教程、Zed 改中文、Zed 语言设置、Zed 界面汉化、代码编辑器汉化、中文代码编辑器、中文 AI 编辑器、编辑器国际化、i18n 中文翻译、Zed 翻译补丁、高性能编辑器中文、协作编辑器汉化
English Zed Chinese localization, Zed zh-CN, Zed Simplified Chinese, Zed Chinese translation, Zed language pack, Zed i18n, Zed localization patch, Zed editor Chinese, Chinese code editor, Chinese AI code editor, Rust editor internationalization, GPUI i18n, Zed UI translation, how to change Zed to Chinese
相关技术 / Related Zed, Zed editor, Rust, GPUI, rust-i18n, i18n, internationalization, localization, 国际化, 本地化, 多语言, multi-language, code editor, 代码编辑器, AI editor, collaborative editing, 协作编辑

