Skip to Content

文件

「文件」(⌘1)在队列里展示当前仓库的工作区,中间检视器负责预览。

文件树

  • 目录按需加载,展开才读取;单个目录最多列出 2000 项,超出部分在底部提示;
  • 显示 Git 状态标记,未跟踪、已修改、已删除与符号链接一眼可辨;
  • 裸仓库没有工作区,该标签会说明原因而不是显示空列表。

预览

  • 文本预览上限为 512 KiB 或 5000 行,超出时提示用外部应用打开;
  • 二进制文件不渲染,直接给出用默认应用打开的入口;
  • Markdown 可以在渲染视图与源码之间切换;已删除的文件显示 HEAD 中的版本;
  • 预览内容可以复制。

预览是只读的。编辑请用外部编辑器,或直接在文件树里做文件级操作。

快速打开与搜索

入口行为
⌘P / Ctrl+P模糊匹配所有已跟踪与未跟踪文件,最近打开过的排在前面,⌘⏎ 直接在编辑器中打开
名称搜索通过 git ls-files 匹配路径,支持 ext:go、*.go 这类过滤
内容搜索通过 git grep 搜索工作区内容,尊重 .gitignore,跳过二进制文件
⌘⇧F直接跳到文件标签页

搜索结果有上限(最多 500 条),达到上限时会提示缩小范围。搜索可以被取消,取消后进程会被终止,不会在后台继续跑。

文件操作

  • 新建文件、新建文件夹;
  • 重命名、制作副本;
  • 复制、剪切、粘贴;
  • 删除,删除前需要确认。

所有操作都限定在当前仓库根目录内:路径不会越出根目录,.git 目录不可写,指向根目录之外的符号链接不会被跟随。

粘贴时优先导入系统剪贴板里的文件;只有文本或图片数据时,分别写成 pasted.txt 或 pasted.png,大小上限 8 MiB。同一目录下重名不会覆盖,会按 copy、copy 2 这类后缀生成新名字;移动操作会先检查全部目标路径,绝不覆盖已有文件。

文件操作只影响磁盘与工作区,不改写 Git 历史。删除已跟踪文件后,变更列表里会出现对应的删除记录。

外部编辑器

应用会检测系统里已安装的编辑器,例如 Cursor、VS Code、Zed 等。

  • 从「在编辑器中打开」菜单选择目标,选择会被记住,之后默认用它;
  • 也可以选择「系统默认应用」;
  • 快速打开里用 ⌘⏎ 直接在选中的编辑器里打开文件;
  • 无法识别的编辑器不会被执行。
最后更新于