🖥️ terminal-setup

一键配置终端环境，支持 macOS、Debian/Ubuntu 和 Windows (WSL)。

支持平台

平台	状态	包管理器
🍎 macOS	✅ 主力平台 — 长期使用验证	Homebrew
🐧 Debian / Ubuntu	🧪 实验性 — 可用但未经长期测试	apt + 远程下载
🪟 Windows (WSL)	🧪 实验性 — 可用但未经长期测试	apt（WSL 内部）

快速开始

macOS

git clone https://github.com/aotemiao/terminal-setup.git
cd terminal-setup && ./setup.sh

Debian / Ubuntu

git clone https://github.com/aotemiao/terminal-setup.git
cd terminal-setup && ./setup.sh

Windows (WSL)

先安装 WSL（如果还没有）：

# 在 PowerShell（管理员）中运行
wsl --install

然后在 WSL 中：

git clone https://github.com/aotemiao/terminal-setup.git
cd terminal-setup && ./setup.sh

一行命令（自动 clone）：

bash <(curl -fsSL https://raw.githubusercontent.com/aotemiao/terminal-setup/main/setup.sh)

Shell

本项目只配置 Zsh，并安装 zsh-autosuggestions、zsh-syntax-highlighting、zsh-completions。

项目	内容
Shell	🐚 Zsh
POSIX 兼容	✅ 兼容
自动补全建议	✅ 通过插件
语法高亮	✅ 通过插件
Node 管理	fnm
配置文件	~/.zshrc + ~/.config/terminal-setup/zshrc.managed

工具栈

组件	说明
Ghostty	GPU 加速终端模拟器
Zsh	Shell
Starship	跨 Shell 提示符（Catppuccin Mocha 主题）
MesloLGS NF	Nerd Font，提供图标和 Powerline 字形
bat	带语法高亮和行号的 cat
eza	带图标、git 状态、树形视图的 ls
fd	更快更直观的 find
ripgrep	比 grep 快几个数量级
fzf	模糊查找器（Ctrl+R / Ctrl+T / Alt+C）
btop	漂亮的系统监控
zoxide	智能 cd，学习你的习惯
jq	JSON 处理器
tldr	简化版 man 手册，附带示例
delta	带语法高亮的 git diff
lazygit	Git 终端 UI
thefuck	自动修正上一条输错的命令
fnm	快速 Node 版本管理器（Rust 编写）
Zellij	现代终端复用器（可选）

脚本做了什么

1. 安装包管理器（macOS 用 Homebrew，Linux 用 apt）
2. 安装 Ghostty 终端（macOS；Linux 需手动安装）
3. 下载 MesloLGS NF Nerd 字体
4. 安装 Zsh + 插件
5. 安装所有 CLI 工具（macOS 用 Homebrew，Linux 用 apt + GitHub releases）
6. 安装 Starship 提示符 + Catppuccin Mocha 配置
7. 安装 fnm + Node.js LTS（可选）
8. 安装 Zellij 终端复用器（可选）
9. 部署所有配置文件（已有配置会加时间戳备份）

平台说明

macOS

• 完整支持，所有工具通过 Homebrew 安装
• Ghostty 作为原生 macOS 应用安装

Debian / Ubuntu

• CLI 工具优先用 apt 安装，apt 没有的从 GitHub releases 或官方安装器下载（delta、lazygit、eza、tealdeer、starship、zellij）
• bat 在 Debian 上叫 batcat，fd 叫 fdfind — 脚本会自动创建软链接
• 字体从 Nerd Fonts 官方 release 下载并安装到 ~/.local/share/fonts/
• Ghostty 不在 apt 里 — 可通过 snap、源码编译 安装，或用其他终端
• Zsh 插件通过 apt 或 git clone 安装

Windows (WSL)

• 所有操作在 WSL 内部执行（Ubuntu/Debian 层）
• 终端模拟器在 Windows 侧运行 — 推荐 Windows Terminal 或 Ghostty for Windows
• 脚本自动检测 WSL 环境并适配
• 如果在原生 Windows（MINGW/Git Bash）中运行，脚本会提示安装 WSL

别名 / 缩写

快捷方式	展开为
ls	eza --icons --group-directories-first
ll	eza -la --icons --group-directories-first
lt	eza --tree --icons --level=2
cat	bat
find	fd
grep	rg
top	btop
lg	lazygit
fuck	修正上一条输错的命令

fzf 快捷键

按键	功能
Ctrl+R	模糊搜索命令历史
Ctrl+T	模糊查找文件（用 fd 作为后端）
Alt+C	模糊进入目录

Zellij

如果选择安装 Zellij，脚本会写入一个最小 ~/.config/zellij/config.kdl，避免首次启动时进入配置向导或 release notes 页面。

当前默认：

show_startup_tips false
show_release_notes false

fnm — Node 版本管理

fnm install 22            # 安装 Node 22
fnm install --lts         # 安装最新 LTS
fnm default 22            # 设置默认版本
fnm use 22                # 当前 shell 切换
echo "22" > .node-version # 进入目录自动切换

SSH Key 切换

Zsh 配置内置了 set-ssh-key 函数：

set-ssh-key my-key-name     # 清空 agent，加载 ~/.ssh/my-key-name
set-ssh-key                  # key 不存在时列出所有可用 key

最佳实践： 推荐在 ~/.ssh/config 里用 Host 别名 + IdentitiesOnly yes 实现自动匹配。set-ssh-key 是兜底方案。

License

MIT