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 等。

  • 從「在編輯器中打開」菜單選擇目標,選擇會被記住,之後默認用它;
  • 也可以選擇「系統默認應用」;
  • 快速打開裏用 ⌘⏎ 直接在選中的編輯器裏打開文件;
  • 無法識別的編輯器不會被執行。
最後更新於