Git-Scope 用户指南
发布: (2025年12月10日 GMT+8 16:38)
3 min read
原文: Dev.to
Source: Dev.to
简介
Git‑Scope 是一个用于本地 Git 仓库的终端仪表盘。
不必再 cd 进文件夹去查看状态。扫描你的项目,即可实时看到整个工作负载的仪表盘。
安装
brew tap Bharath-code/tap
brew install git-scope
or, using Go:
go install github.com/Bharath-code/git-scope/cmd/git-scope@latest
命令
| 命令 | 描述 |
|---|---|
git-scope | 启动仪表盘(默认) |
git-scope scan | 以 JSON 形式打印仓库列表 |
git-scope scan-all | 从主目录扫描整个系统 |
git-scope init | 创建配置文件 |
git-scope -h | 显示帮助 |
标志
-config:配置文件路径(默认:~/.config/git-scope/config.yml)
仪表盘概览
运行 git-scope 时,每个仓库条目显示:
- Status:
●脏(未提交/未推送)或✓干净 - Repository:项目文件夹名称
- Branch:当前分支(例如
main) - Staged:已暂存待提交的文件
- Modified:已修改的文件
- Untracked:新文件
- Last Commit:距上次提交的时间
Git‑Scope 以键盘操作为主。
键位绑定
| 键 | 操作 |
|---|---|
k / ↑ | 向上移动 |
j / ↓ | 向下移动 |
q | 退出 |
/ | 搜索(模糊匹配;例如 gscope 能找到 git-scope) |
Enter | 确认选择 |
Esc | 取消搜索 |
f | 切换 Dirty Filter – 只显示有未提交或未推送更改的仓库 |
s | 循环排序方式:Dirty First(默认)→ Name → Last Modified |
r | 重新扫描文件系统 |
c | 清除搜索 |
操作
| 键 | 操作 |
|---|---|
Enter | 在 $EDITOR 中打开仓库 |
r | 重新扫描文件系统 |
c | 清除当前搜索 |
使用技巧
- Git‑Scope 会在当前目录递归搜索 Git 仓库。
- 最佳做法是从
~/projects(或类似的顶层文件夹)运行它。 node_modules目录会自动被忽略。- 结果会被缓存以提升速度(通常 <10 ms)。如有需要,按
r刷新缓存。 - 查看 Sync 列中的
↓(落后于远程)。 - 按
f只查看脏仓库,然后按Enter打开并修复它们。
入门指南
- 在 GitHub 上给项目加星。
- 访问官方网站获取更多信息。