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