文件与项目管理

这一章解决什么问题

帮助你掌握在 Zed 中管理文件和项目的核心操作，包括新建文件、浏览项目、使用文件搜索等。

资料来源

• Zed 官方文档 - Project Panel
• Zed 官方文档 - File Finder
• Zed 官方文档 - Working with Files

你会在什么时候用到它

• 日常新建、打开、移动文件
• 在大型项目中快速定位文件
• 管理多工作区

打开项目

Zed 以文件夹为单位打开项目。一个 Zed 窗口对应一个项目文件夹。

打开文件夹

1. Ctrl+O 或菜单 → Open Folder
2. 在文件对话框中选择项目根目录
3. 点击 Open Folder

打开最近的项目

• Ctrl+Shift+P → 输入 open recent
• 或点击菜单中的 Recent 列表

多工作区（Multi-root Workspaces）

Zed 支持在一个窗口中打开多个不相关的文件夹：

1. 命令面板 → add folder to workspace
2. 选择要添加的文件夹
3. 项目面板会显示多个根文件夹

文件树操作

项目面板（左侧）显示项目文件树，以下是常用操作：

新建文件/文件夹

操作	方式
新建文件	在项目面板空白处右键 → New File 或 Ctrl+N
新建文件夹	右键 → New Folder
在指定目录下创建	先选中目标文件夹，再执行新建

创建文件时可以直接输入路径，例如：

src/components/Button.tsx

这会同时创建 components 文件夹和 Button.tsx 文件。

文件操作

操作	快捷键	说明
重命名	F2	重命名文件或文件夹
删除	Delete	会弹出确认对话框
复制	Ctrl+C	复制选中文件
粘贴	Ctrl+V	粘贴到当前位置
在文件系统中显示	右键 → Reveal in File Explorer	在资源管理器中打开
复制路径	右键 → Copy Path	复制文件完整路径

Windows 路径注意

在 Windows 上复制路径时，默认是反斜杠（\）格式。如果你需要 Unix 风格的路径（如用于配置），可能需要手动替换。

文件树导航

快捷键	功能
↑ / ↓	上下移动选择
Enter	打开选中的文件
Right	展开文件夹
Left	折叠文件夹
Ctrl+Shift+E	聚焦/取消聚焦项目面板

自动展开当前文件

当在编辑器中切换文件时，项目面板可以自动展开并高亮当前文件：

{
  "project_panel": {
    "auto_reveal_entries": true
  }
}

快速打开文件（File Finder）

在大型项目中，在文件树中逐层查找效率很低。使用 File Finder 可以按文件名快速打开文件。

打开方式

• 快捷键：Ctrl+P
• 输入文件名或路径的一部分进行模糊匹配

使用技巧

技巧	说明
模糊匹配	输入 btnts 可匹配 components/Button.tsx
路径匹配	输入 src/btn 缩小范围
最近文件	Ctrl+P 后不按任何键，显示最近打开的文件
快速切换	连按两次 Ctrl+P 切换到上一个文件

快速打开符号

• Ctrl+T：搜索项目中的符号（函数、类、变量）
• Ctrl+Shift+O：搜索当前文件中的符号
• Ctrl+G：跳转到指定行号

文件编辑基础

新建未保存的文件

按 Ctrl+N 可以创建一个新的未命名缓冲区：

1. Ctrl+N 创建新文件
2. 开始编辑
3. Ctrl+S 保存时输入文件名和路径

自动保存

Zed 支持自动保存功能：

{
  "autosave": {
    "after_delay": {
      "milliseconds": 1000
    }
  }
}

自动保存模式选项：

• "off" — 关闭自动保存
• "after_delay" — 停止输入后延迟保存
• "on_focus_change" — 焦点离开编辑器时保存
• "on_window_change" — 窗口失焦时保存

推荐设置

建议开发时使用 "after_delay"（1000ms），这样既能防止丢失工作，又不会因为频繁保存触发不必要的构建。

文件编码和换行符

状态栏显示当前文件的编码和换行符类型：

指示器	含义
UTF-8	文件编码
LF	Unix 风格换行
CRLF	Windows 风格换行

点击状态栏的编码或换行符指示器可以切换格式。

Windows 换行符建议

Windows 用户建议使用 LF 换行（特别是参与开源项目时），避免 Git 显示大量换行符差异。可以在 settings.json 中设置：

{
  "line_ending": "\n"
}

文件排除

Zed 默认会忽略某些文件（如 node_modules、.git 等）。你可以自定义排除规则：

{
  "files": {
    "exclude": [
      "node_modules",
      ".git",
      "target",
      "dist",
      "build",
      "*.log"
    ]
  }
}

被排除的文件：

• 不会显示在项目面板中
• 不会参与搜索
• 仍可以通过 Ctrl+P 直接输入路径打开

本章小结

• Zed 以文件夹为单位管理项目，Ctrl+O 打开项目
• 项目面板用于浏览和操作文件树
• Ctrl+P 是最高效的文件打开方式
• 支持自动保存，推荐 "after_delay" 模式
• Windows 用户建议统一使用 LF 换行符

小练习

1. 用 Ctrl+N 创建一个新文件，编辑后保存到 src/utils/hello.ts
2. 用 Ctrl+P 找到一个深层嵌套的文件
3. 在项目面板中重命名一个文件
4. 将自动保存设置为 "after_delay": 1000