资料来源与延伸阅读
这套教程怎样整理
本教程不是逐句翻译官方文档，而是按 Windows 用户的真实使用路径重新组织：
text
打开 Zed -> 认识界面 -> 找文件和编辑 -> 运行项目 -> Git 提交 -> 配置和扩展 -> AI 辅助 -> 工程化使用资料优先级如下：
- Zed 官方文档、官方博客、官方扩展市场
- Zed GitHub 主仓库和扩展仓库
- 官方功能页面和迁移指南
- 社区教程、配置示例、视频教程
- 本教程在 Windows 上的实际运行验证
WARNING
Zed 更新很快，尤其是 Windows、AI、Git 和扩展相关功能。遇到教程与实际界面不一致时，以当前版本的 Zed 和官方文档为准。
官方核心资料
| 资料 | 链接 | 用途 |
|---|---|---|
| Zed 官网 | https://zed.dev/ | 产品入口、下载入口 |
| Zed 官方文档 | https://zed.dev/docs/ | 本教程主要依据 |
| Windows 文档 | https://zed.dev/docs/windows | Windows 安装、已知限制、排错 |
| 设置文档 | https://zed.dev/docs/configuring-zed | settings.json、项目配置 |
| 全部设置参考 | https://zed.dev/docs/configuring-zed?highlight=settings | 查具体配置项 |
| 快捷键文档 | https://zed.dev/docs/key-bindings | 快捷键和键位自定义 |
| 终端文档 | https://zed.dev/docs/terminal | 内置终端和 shell 配置 |
| 任务文档 | https://zed.dev/docs/tasks | 项目任务、重复命令 |
| Git 文档 | https://zed.dev/docs/git | Git 面板、diff、提交 |
| AI 概览 | https://zed.dev/docs/ai/overview | AI 功能总体说明 |
| Agent Panel | https://zed.dev/docs/ai/agent-panel | Agent 面板用法 |
| Agent Settings | https://zed.dev/docs/ai/agent-settings | AI 模型和服务配置 |
| 语言支持 | https://zed.dev/docs/languages | 语言服务、格式化、诊断 |
| VS Code 迁移 | https://zed.dev/docs/migrate/vs-code | VS Code 用户迁移 |
| 远程开发 | https://zed.dev/docs/remote-development | SSH、远程项目 |
| 协作功能 | https://zed.dev/docs/collaboration/overview | 多人协作能力 |
官方项目与市场
| 资料 | 链接 | 用途 |
|---|---|---|
| Zed 主仓库 | https://github.com/zed-industries/zed | 源码、Issue、版本变化 |
| Zed 扩展仓库 | https://github.com/zed-industries/extensions | 官方扩展生态 |
| Zed 扩展市场 | https://zed.dev/extensions | 搜索语言、主题、工具扩展 |
| Git 功能页 | https://zed.dev/git | Git 功能展示 |
| 下载页 | https://zed.dev/download | 获取 Windows 版本 |
官方博客与版本信息
| 资料 | 链接 | 用途 |
|---|---|---|
| Zed Blog | https://zed.dev/blog | 发布说明和功能变化 |
| Zed for Windows | https://zed.dev/blog/zed-for-windows | Windows 版本背景 |
| Release Notes | https://zed.dev/releases | 了解近期功能变化 |
社区资料怎样使用
社区资料适合补充真实经验，但不能直接当成最终结论。使用时要注意：
- 看发布日期，过旧内容可能已经失效
- 看平台，macOS 快捷键不能直接套到 Windows
- 看配置项是否仍在官方文档里
- 看评论和 Issue，确认是不是个别环境问题
可搜索的关键词：
| 方向 | 搜索词 |
|---|---|
| 入门教程 | Zed editor tutorial |
| Windows 使用 | Zed editor Windows tutorial |
| 配置示例 | Zed editor settings.json example |
| AI 使用 | Zed Agent Panel tutorial |
| 前端开发 | Zed editor React TypeScript |
| VS Code 迁移 | Zed migrate from VS Code |
视频教程怎样筛选
视频教程适合看界面操作，但要筛选：
- 优先看最近一年发布或更新的视频
- 优先看 Windows 实机演示
- 注意视频里的快捷键是否是 macOS
- 不要照抄长配置，先理解每一项作用
搜索词：
text
Zed editor tutorial Windows
Zed editor AI Agent Panel
Zed editor Git workflow
Zed editor settings本教程已验证的内容
在当前项目中已经验证：
- VitePress 教程站能安装依赖
- 本地服务能启动
- 首页、教程页、实践页能打开
- 构建命令能通过
- 缺失图片问题已修复
仍需持续维护的内容
| 内容 | 为什么要复查 |
|---|---|
| Windows 版本能力 | Zed Windows 版本仍在持续完善 |
| AI 面板和模型配置 | AI 功能更新快 |
| Git 面板细节 | 交互可能随版本变化 |
| 扩展市场 | 扩展数量和质量持续变化 |
| 快捷键 | 不同平台和键盘布局可能不同 |
| 远程开发 | SSH、WSL、容器相关体验会变化 |
参与改进
如果你发现教程内容与当前 Zed 不一致，建议按这个顺序处理：
- 先确认本机 Zed 版本
- 查官方文档或 Release Notes
- 查 GitHub Issue 是否已有说明
- 再更新教程内容
- 本地运行并构建确认