Windows 工程化使用

这一章解决什么问题

把 Zed 当主力编辑器，不只是能打开文件，还要能稳定处理真实工程：

• Windows 本机项目
• WSL 项目
• SSH 远程项目
• 前端、Python、Go、Rust 等多语言项目
• Git 分支和工作树
• AI 辅助开发
• 开源项目维护

这一章给一套 Windows 用户可落地的使用方式。

推荐目录习惯

建议把代码放在一个固定目录下，例如：

D:\projects
G:\llmProject

不要把长期项目放在桌面、下载目录或带同步冲突的网盘目录里。Zed 会频繁读写项目文件、索引文件、Git 状态，稳定的本地路径更省心。

本机项目、WSL、SSH 怎么选

项目位置	适合场景	建议
Windows 本机目录	前端、文档、小工具、普通脚本	默认首选
WSL	Linux 依赖重、Docker/后端项目	代码尽量放 WSL 文件系统内
SSH 远程	服务器调试、远程开发机	适合已有远程环境

如果你主要做文档站、前端页面、开源教程，本机目录就够了。需要 Linux 环境时，再引入 WSL 或 SSH。

Windows 终端选择

Windows 用户常见三种 shell：

Shell	适合谁
PowerShell	Windows 默认，适合大多数本机项目
Git Bash	熟悉 Linux 命令、Git 操作较多的人
WSL Bash	项目依赖 Linux 环境的人

建议先用 PowerShell。只有项目明确依赖 Linux 工具链时，再切到 WSL。

如果要让 Zed 终端默认从项目根目录打开：

{
  "terminal": {
    "working_directory": "current_project_directory"
  }
}

每个项目建议保留的文件

一个适合开源和长期维护的 Zed 项目，建议至少有这些内容：

文件	作用
README.md	告诉别人这个项目是什么、怎么运行
package.json / 对应语言配置	提供统一命令入口
.zed/tasks.json	给 Zed 用户一键运行任务
.gitignore	避免提交本地临时文件
docs/	放教程、说明、部署文档

如果项目以后要部署到 Cloudflare Pages、GitHub Pages 或其他平台，还应该让 build 命令稳定可用。

推荐的日常工程流程

1. 打开项目

cd G:\llmProject\myOpenProject\Zed编辑器实战教程\app
zed .

2. 运行项目

优先用项目任务或 package 脚本：

npm run dev

3. 修改内容

用 Ctrl+P 找文件，用全局搜索定位旧内容。文档站项目尤其要注意链接是否能打开、图片是否存在、目录是否完整。

4. 本地检查

每次准备提交前至少跑一次：

npm run build

如果是后端或脚本项目，就换成对应的测试命令。

5. 看 diff 再提交

打开 Git 面板，逐个文件看改动。不要只看文件名就提交，尤其是文档站，容易不小心把构建产物、临时日志、截图缓存一起提交。

适合开源项目的 Zed 使用方式

开源前建议整理三件事：

1. 首页说明清楚
2. 本地运行命令简单
3. 构建检查稳定

对于这个 VitePress 教程站，比较理想的命令是：

npm install
npm run dev
npm run build

如果后面部署到 Cloudflare Pages，通常只需要配置：

配置项	建议值
构建命令	npm run build
输出目录	docs/.vitepress/dist
Node 版本	使用当前项目能通过构建的版本

AI 辅助开发怎么用才稳

Zed 的 AI 能帮你解释代码、修改文件、生成提交说明，但不要把它当成自动正确的结果。

建议这样用：

场景	推荐问法
看不懂文件	“解释这个文件负责什么，用中文概括”
改文档	“按 Windows 用户实际操作重写这一段”
查问题	“根据报错找可能原因，不要直接改代码”
生成提交说明	“根据当前 diff 写一条简洁提交说明”

AI 改完后，一定要看 diff，并重新运行项目或构建。

Windows 常见问题处理顺序

Zed 打不开或黑屏

优先检查显卡驱动、DirectX 支持和 Windows 更新。Zed 的 Windows 版本依赖本机图形能力，虚拟机或旧驱动更容易出问题。

终端命令找不到

先在外部 PowerShell 里试。外部也找不到，就不是 Zed 的问题，先修工具安装和环境变量。

Git 面板不显示改动

确认打开的是仓库根目录或仓库内部目录。再用终端运行：

git status

如果终端也看不到 Git 仓库，说明当前目录不对。

图片或链接显示异常

文档站常见原因是路径写错或文件没放到公开目录。处理顺序：

1. 找到页面里引用的路径
2. 确认文件真实存在
3. 用本地地址直接访问图片
4. 重新构建

本章小结

• Windows 本机项目优先用稳定本地目录
• 重复命令沉淀成项目任务
• 每次提交前看 diff 和跑构建
• AI 适合辅助，但结果要验证
• 开源项目要让别人能用三条命令跑起来