README 目录 / zsh

zsh

当前主要 shell 配置包。它把启动流程拆成环境、插件、alias、函数、工具初始化、补全、fzf 和 vi mode，避免所有逻辑挤在一个巨大的 .zshrc 里。

主力 shell Antigen / oh-my-zsh fzf 工作流 vi mode

安装路径

stow -S zsh

会安装 ~/.zshrc、~/.zshenv、~/.zprofile、~/.antigenrc 和 ~/.config/zsh/。

加载顺序

~/.zshrc 先设置 ZSH_CONFIG_DIR="${ZSH_CONFIG_DIR:-$HOME/.config/zsh}"，然后按下面顺序加载：

env.zsh
如果是非交互 shell，直接返回。
plugins.zsh
aliases.zsh
functions.zsh
tools.zsh
completion.zsh
fzf.zsh
vi.zsh

环境层

配置 Homebrew、Python 3.11、OpenJDK 17、jenv、~/.local/bin、Bun、pnpm、VS Code、Obsidian、Antigravity 等路径。
设置 JAVA_HOME，优先 Java 17。
设置 EDITOR=vim、LANG、LC_ALL。
关闭 Homebrew 自动更新，并配置 bottle 镜像。
把 python 和 python3 alias 到 python3.11。

工具层

Antigen 优先从 /opt/homebrew 加载，失败再回退 /usr/local。
读取 ~/.antigenrc 初始化 oh-my-zsh 插件。
加载 autojump、Google Cloud SDK、Bun completion。
懒加载 nvm。
初始化 jenv 和 starship。

fzf 和 vi mode

fzf 默认优先用 fd 作为文件源，失败时用 rg --files。Ctrl+t 选目录并 cd，Ctrl+r 搜历史，Ctrl+p 搜文件并插入命令行，fif <文本> 搜包含文本的文件并预览匹配。

vi mode 会根据 insert/normal mode 切换光标形状，Ctrl+v 可编辑当前命令行。

常用 alias 和函数

基础和 Git

sz：重新加载 ~/.zshrc。
edit：打开 $EDITOR。
up、..、...、....：快速返回上级。
pwdc：打印当前目录并复制到剪贴板。
cleanDS：删除当前目录下 .DS_Store。
gs/gp/gc/gd/gb/gl：Git 状态、推送、切换、diff、分支和格式化 log。

AI、网络和维护

cc、cc-opus：Claude Sonnet / Opus，跳过权限确认。
agy：Antigravity CLI。
cx：Codex，高 reasoning，bypass approvals and sandbox。
proxy / unproxy：设置或取消本地代理。
ipcn、ip：查看公网 IP。
dns：刷新 DNS cache。
update：Homebrew、brew cu、mas 更新。

函数

mkd <dir>：创建目录并进入。
extract <file>：按扩展名解压常见压缩包。
cleannpm：删除 ~/Workspace 下的 node_modules。
cleanm2：删除 ~/.m2。
myip：显示局域网和外网 IP。
hittp <port>：启动 Python HTTP server。

这套 zsh 配置主要面向 macOS 和 Homebrew。推荐依赖包括 antigen、starship、fzf、fd、ripgrep、jenv、autojump、bun、pnpm、nvm。AI alias 带跳过确认参数，使用前确认当前目录和权限边界。