traverse

A blazing-fast TUI file manager for Windows, built in Go.

---

yazi、lf、ranger 都是优秀的 TUI 文件管理器——但它们在 Windows 上要么跑不起来，要么体验割裂：路径分隔符不对、Shell 集成缺失、跨盘操作报错。

traverse 从第一天就为 Windows 设计。 不是"也能在 Windows 上跑"，而是"Windows 用户的第一个现代 TUI 文件管理器"。

Demo

Why not yazi / lf / ranger?

	traverse	yazi	lf	ranger
Windows 原生	✅ 首选平台	⚠️ 二等公民	⚠️ 二等公民	⚠️ 二等公民
PowerShell 集成	✅ Ctrl+Z 打开，自动 cd	❌	❌	❌
跨盘操作	✅ C:\ ↔ D:\ 无感切换	❌ 报错	❌ 报错	❌ 报错
撤销删除	✅ u 键恢复	❌	❌	❌
Git diff 预览	✅ 着色 diff	✅	❌	❌
命令面板	✅ : 模糊搜索	❌	❌	❌
书签	✅	❌	✅	✅
主题系统	✅ catppuccin 等	✅	❌	✅
鼠标支持	✅	✅	❌	✅
语言	Go（单二进制）	Rust	Go	Python

Install

winget（推荐，Windows 自带）

winget install chenyc21.traverse

Scoop（Windows）

scoop install traverse

Go

go install github.com/chenyc21/traverse@latest

手动下载

从 GitHub Releases 下载对应平台的二进制文件，放入 PATH 即可。

Quick Start

# 打开当前目录
traverse

# 打开指定目录
traverse D:\projects

# 打开 UNC 路径（网络驱动器）
traverse \\server\share

进入目录后，按 ? 查看所有快捷键。

Keybindings

点击展开完整快捷键列表

Navigation

Key	Action
k / ↑	Move up
j / ↓	Move down
h / ← / Backspace	Go to parent directory
l / → / Enter	Open file or enter directory
g g	Jump to top (press g twice)
G	Jump to bottom
Ctrl+u	Page up
Ctrl+d	Page down

Filter

Key	Action
/	Enter instant filter mode
Esc	Exit filter, restore full list
Backspace	Remove last filter character

File Operations

Key	Action
y	Copy file
d	Cut file
p	Paste file
x	Delete file (with confirmation, undoable)
r	Rename file (undoable)
n	Create new file
N	Create new directory
u	Undo last delete or rename

Selection

Key	Action
Space	Select / deselect
a	Select all / deselect all

Git

Key	Action
s	Stage file
S	Unstage file
D	View diff in preview

View

Key	Action
Tab	Toggle preview panel
.	Toggle hidden files
o	Cycle sort mode (name / size / time / ext)
R	Refresh current directory
K / J (uppercase)	Scroll preview (when open)

Bookmarks

Key	Action
B	Add current directory as bookmark
b	Show bookmarks list
Ctrl+b	Remove bookmark for current directory

Command Palette

Key	Action
:	Open command palette

Shell

Key	Action
Ctrl+Z	Open PowerShell (auto-cd to current directory)

Mouse

Action	Effect
Click	Select file / enter directory
Scroll wheel	Navigate file list

Other

Key	Action
?	Toggle help
q	Quit

Configuration

配置文件位置：

• Windows: %APPDATA%\traverse\config.yaml
• macOS: ~/Library/Application Support/traverse/config.yaml
• Linux: ~/.config/traverse/config.yaml

完整配置项见 config.example.yaml。

Themes

内置主题：default（经典暗色）、catppuccin-mocha（Catppuccin Mocha）。

在配置文件中设置：

theme: catppuccin-mocha

Syntax Highlighting

预览面板支持以下语言的语法高亮：

Go · Python · JavaScript · TypeScript · Rust · C · C++ · Java · Markdown

其他文本文件以纯文本显示。JSON / YAML 自动格式化。

Building from Source

git clone https://github.com/chenyc21/traverse.git
cd traverse
go build -o traverse .

Contributing

欢迎贡献！见 CONTRIBUTING.md。

License

MIT