446 lines
14 KiB
Markdown
446 lines
14 KiB
Markdown
---
|
||
date: '2026-05-28T22:05:00+08:00'
|
||
draft: false
|
||
title: '我的 Zsh 终端配置：Zinit、Powerlevel10k 与日常效率优化'
|
||
tags:
|
||
- zsh
|
||
- terminal
|
||
- dotfiles
|
||
- zinit
|
||
- powerlevel10k
|
||
categories:
|
||
- 技术
|
||
---
|
||
|
||
## 前言
|
||
|
||
一个好用的 Shell 配置，不应该只是“看起来很酷”。它更应该做到三件事：
|
||
|
||
1. **启动快**：进入终端后立刻可输入命令，而不是等待一堆插件初始化。
|
||
2. **提示准**：当前目录、Git 状态、命令执行结果、语言环境等信息一眼可见。
|
||
3. **操作顺手**：常用命令短、路径跳转快、补全和历史建议足够智能。
|
||
|
||
这篇文章记录我的 Zsh 配置思路。整体方案是：**Zinit 管理插件，Powerlevel10k 负责提示符，Oh My Zsh 提供成熟插件生态，再配合 eza、yazi、pnpm、n 等工具优化日常开发体验**。
|
||
|
||
<!--more-->
|
||
|
||
## 整体结构
|
||
|
||
我的 Zsh 配置主要由两个文件组成：
|
||
|
||
```text
|
||
~/.zshrc # 主配置：环境变量、zinit、插件、别名、函数
|
||
~/.p10k.zsh # Powerlevel10k 主题配置
|
||
```
|
||
|
||
加载顺序大致如下：
|
||
|
||
```text
|
||
启动 Zsh
|
||
|
|
||
v
|
||
Powerlevel10k instant prompt
|
||
|
|
||
v
|
||
基础环境变量与 Shell options
|
||
|
|
||
v
|
||
加载 zinit
|
||
|
|
||
v
|
||
加载 OMZ library / Powerlevel10k / 插件
|
||
|
|
||
v
|
||
source ~/.p10k.zsh
|
||
|
|
||
v
|
||
注册 alias / function / PATH
|
||
```
|
||
|
||
这种拆分的好处是：`.zshrc` 保持“启动流程与插件管理”，`.p10k.zsh` 专注“提示符长什么样”。以后更换主题时，也不会影响插件和别名体系。
|
||
|
||
## 用 instant prompt 提升启动体验
|
||
|
||
配置最顶部是 Powerlevel10k 的 instant prompt：
|
||
|
||
```zsh
|
||
if [[ -r "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh" ]]; then
|
||
source "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh"
|
||
fi
|
||
```
|
||
|
||
它的作用是：在完整配置加载完成之前，先显示一个临时 Prompt，让终端看起来“秒开”。
|
||
|
||
同时我设置了：
|
||
|
||
```zsh
|
||
typeset -g POWERLEVEL9K_INSTANT_PROMPT=quiet
|
||
```
|
||
|
||
这样可以减少 instant prompt 对启动时输出内容的干扰。对于需要频繁打开新终端、tmux pane 或远程会话的人来说，这一点体验提升很明显。
|
||
|
||
## 基础环境与 Zsh options
|
||
|
||
```zsh
|
||
path=(~/.local/bin $path)
|
||
typeset -x XDG_CONFIG_HOME="${XDG_CONFIG_HOME:-$HOME/.config}"
|
||
|
||
setopt correct
|
||
setopt interactive_comments
|
||
```
|
||
|
||
这里做了几个基础设定：
|
||
|
||
| 配置 | 作用 |
|
||
|------|------|
|
||
| `~/.local/bin` 前置到 `PATH` | 优先使用用户级安装的命令 |
|
||
| `XDG_CONFIG_HOME` | 统一配置目录，默认指向 `~/.config` |
|
||
| `setopt correct` | 命令输错时给出纠正建议 |
|
||
| `setopt interactive_comments` | 交互式 Shell 中也允许使用 `#` 注释 |
|
||
|
||
`interactive_comments` 很适合在终端里临时记录命令意图，比如粘贴多行命令时可以保留注释说明。
|
||
|
||
## 为什么选择 Zinit
|
||
|
||
插件管理器我使用的是 Zinit：
|
||
|
||
```zsh
|
||
ZINIT_HOME="${XDG_DATA_HOME:-${HOME}/.local/share}/zinit/zinit.git"
|
||
[[ ! -d "${ZINIT_HOME}" ]] && mkdir -p "$(dirname "${ZINIT_HOME}")"
|
||
[[ ! -d "${ZINIT_HOME}/.git" ]] && git clone https://gh-proxy.org/https://github.com/zdharma-continuum/zinit.git "${ZINIT_HOME}"
|
||
source "${ZINIT_HOME}/zinit.zsh"
|
||
```
|
||
|
||
Zinit 的核心价值是：**可以精细控制插件加载时机**。比如有些插件必须同步加载，有些插件可以延迟 1 秒、2 秒、3 秒再加载；对于启动速度敏感的 Shell 配置来说，这比简单地 `source` 一堆脚本更可控。
|
||
|
||
配置里还使用了 GitHub 代理地址，主要是为了在国内网络环境下更稳定地安装 Zinit。你也可以按自己的网络情况替换为官方仓库地址。
|
||
|
||
## 先加载 Oh My Zsh 的基础库
|
||
|
||
我没有直接使用完整的 Oh My Zsh 框架，而是通过 Zinit 按需加载其中的 library 和 plugin。
|
||
|
||
同步加载的 OMZ library：
|
||
|
||
```zsh
|
||
for i in theme-and-appearance.zsh git.zsh prompt_info_functions.zsh history.zsh; do
|
||
zinit snippet "OMZL::${i}"
|
||
done
|
||
```
|
||
|
||
延迟加载的 OMZ library：
|
||
|
||
```zsh
|
||
for i in completion.zsh key-bindings.zsh; do
|
||
zinit ice lucid wait="1"
|
||
zinit snippet "OMZL::${i}"
|
||
done
|
||
```
|
||
|
||
这里的思路是：
|
||
|
||
| 类型 | 加载策略 | 原因 |
|
||
|------|----------|------|
|
||
| theme / git / prompt / history | 同步加载 | 主题和提示符依赖，越早越好 |
|
||
| completion / key-bindings | 延迟加载 | 对首屏 Prompt 不是硬依赖 |
|
||
|
||
补全初始化则交给：
|
||
|
||
```zsh
|
||
zpcompinit
|
||
zpcdreplay
|
||
```
|
||
|
||
这样可以配合 Zinit 的补全 replay 机制，让插件延迟加载后仍然能正确注册补全。
|
||
|
||
## Powerlevel10k：两行式 Prompt
|
||
|
||
主题使用 Powerlevel10k：
|
||
|
||
```zsh
|
||
zinit ice depth=1
|
||
zinit light romkatv/powerlevel10k
|
||
|
||
[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh
|
||
```
|
||
|
||
`depth=1` 可以减少 clone 体积，只拉取必要历史。
|
||
|
||
我的 `.p10k.zsh` 是通过 `p10k configure` 生成的 rainbow 风格配置，主要特点是：
|
||
|
||
| 项目 | 配置 |
|
||
|------|------|
|
||
| 字体 | Nerd Font v3 |
|
||
| 风格 | powerline + rainbow |
|
||
| Prompt | 两行式 |
|
||
| 分隔符 | angled separators |
|
||
| 图标 | small icons / many icons |
|
||
| 显示密度 | sparse、concise |
|
||
|
||
左侧 Prompt 保留最核心的信息：
|
||
|
||
```zsh
|
||
POWERLEVEL9K_LEFT_PROMPT_ELEMENTS=(
|
||
os_icon
|
||
dir
|
||
vcs
|
||
newline
|
||
prompt_char
|
||
)
|
||
```
|
||
|
||
右侧 Prompt 则放一些上下文信息，例如命令状态、执行耗时、后台任务、Python 虚拟环境、Node 环境、Kubernetes context、Terraform workspace、云 CLI profile、时间等。
|
||
|
||
这种布局的优点是：**左边只显示当前操作最常用的信息，右边显示“有就看、没有也不影响”的上下文**。两行式 Prompt 也能避免路径太长时挤压命令输入区域。
|
||
|
||
## 插件设计：按“必要程度”延迟加载
|
||
|
||
我的插件并不是一股脑同步加载，而是按使用频率和必要程度分层。
|
||
|
||
| 插件 | 加载方式 | 用途 |
|
||
|------|----------|------|
|
||
| `command-not-found` | `wait=0` | 命令不存在时提示可安装的软件包 |
|
||
| `colored-man-pages` | `wait=3` | 彩色 man 页面 |
|
||
| `fast-syntax-highlighting` | async | 命令行语法高亮 |
|
||
| `zsh-autosuggestions` | async + `atload` | 基于历史记录的命令建议 |
|
||
| `sudo` | `wait=2` | 双击 `Esc` 给当前命令加 `sudo` |
|
||
| `z` | `wait=1` | 根据访问频率跳转目录 |
|
||
| `git` | `wait=1` | Git 常用别名与函数 |
|
||
| `extract` | `wait=1` | 一条命令解压多种格式 |
|
||
| `kubectl` | `wait=1` | Kubernetes 别名、补全与辅助函数 |
|
||
|
||
其中最影响交互体验的是两个插件：
|
||
|
||
```zsh
|
||
zinit light zdharma-continuum/fast-syntax-highlighting
|
||
zinit light zsh-users/zsh-autosuggestions
|
||
```
|
||
|
||
- `fast-syntax-highlighting`：输入命令时实时高亮，能提前发现命令、路径、参数是否写错。
|
||
- `zsh-autosuggestions`：根据历史记录给出灰色建议，按右方向键即可补全。
|
||
|
||
这两个插件会让命令行从“纯文本输入框”变成“带反馈的交互环境”。
|
||
|
||
## 文件列表：eza 优先，ls 兜底
|
||
|
||
我把常用 `ls` 系列命令封装成了别名，如果系统安装了 `eza`，就优先使用 `eza`：
|
||
|
||
```zsh
|
||
if [[ -n "$(command -v eza)" ]]; then
|
||
DISABLE_LS_COLORS=true
|
||
alias ls='eza --color=auto'
|
||
alias l='eza -lbah --icons=auto'
|
||
alias la='eza -labgh --icons=auto'
|
||
alias ll='eza -lbg --icons=auto'
|
||
alias lt='eza -lTbg --icons=auto'
|
||
alias lsa='eza -lbagR --icons=auto'
|
||
alias lst='eza -lTabgh --icons=auto'
|
||
else
|
||
alias ls='ls --color=auto'
|
||
alias l='ls -lah'
|
||
alias la='ls -lAh'
|
||
alias ll='ls -lh'
|
||
alias lsa='ls -lah'
|
||
alias lst='tree -pCsh'
|
||
fi
|
||
```
|
||
|
||
常用别名含义如下：
|
||
|
||
| 别名 | 作用 |
|
||
|------|------|
|
||
| `l` | 长列表，显示隐藏文件、人类可读大小、图标 |
|
||
| `la` | 类似 `l`，但更适合查看权限和分组信息 |
|
||
| `ll` | 简洁长列表 |
|
||
| `lt` | 树状展示目录 |
|
||
| `lsa` | 递归列出所有文件 |
|
||
| `lst` | 树状递归展示并包含隐藏文件 |
|
||
|
||
这里的关键是“有增强工具就增强，没有就优雅降级”。配置可以在新机器上直接使用，不会因为缺少 `eza` 导致 Shell 启动失败。
|
||
|
||
## 路径跳转与目录历史
|
||
|
||
```zsh
|
||
alias ...=../..
|
||
alias ....=../../..
|
||
alias .....=../../../..
|
||
alias ......=../../../../..
|
||
|
||
alias 1='cd -'
|
||
alias 2='cd -2'
|
||
alias 3='cd -3'
|
||
# ...一直到 9
|
||
```
|
||
|
||
这组别名解决两个常见问题：
|
||
|
||
1. 多级返回目录时不用反复输入 `cd ../../..`。
|
||
2. 在多个目录之间来回切换时，可以直接用 `1` 到 `9` 访问目录栈。
|
||
|
||
配合 OMZ 的 `z` 插件，可以覆盖两类跳转场景：
|
||
|
||
- **已知相对路径**：使用 `...`、`....`。
|
||
- **经常访问的目录**：使用 `z <keyword>`。
|
||
|
||
## yazi：退出文件管理器后自动 cd
|
||
|
||
配置中有一个很实用的 `y()` 函数：
|
||
|
||
```zsh
|
||
function y() {
|
||
local tmp cwd
|
||
tmp="$(mktemp -t yazi-cwd.XXXXXX)"
|
||
yazi "$@" --cwd-file="$tmp"
|
||
cwd="$(cat -- "$tmp")"
|
||
if [[ -n "$cwd" && "$cwd" != "$PWD" ]]; then
|
||
builtin cd -- "$cwd"
|
||
fi
|
||
rm -f -- "$tmp"
|
||
}
|
||
```
|
||
|
||
普通文件管理器的问题是：你在里面进入了某个目录，但退出后 Shell 仍然停留在原目录。这个函数通过 `--cwd-file` 记录 yazi 退出时所在目录，然后让当前 Shell 自动 `cd` 过去。
|
||
|
||
实际体验就是：
|
||
|
||
```bash
|
||
y
|
||
# 在 yazi 中进入目标目录
|
||
# 退出 yazi 后，Shell 自动切换到那个目录
|
||
```
|
||
|
||
这比在终端里反复 `cd`、`ls`、再 `cd` 要顺手很多。
|
||
|
||
## Git、解压、sudo 与搜索
|
||
|
||
除了视觉和补全，我还保留了一些非常实用的小别名：
|
||
|
||
```zsh
|
||
alias _='sudo '
|
||
alias gc1='git clone --recursive --depth=1'
|
||
alias md='mkdir -p'
|
||
alias rd='rmdir'
|
||
alias afind='ack -il'
|
||
alias grep='grep --color=auto'
|
||
alias egrep='egrep --color=auto'
|
||
alias fgrep='fgrep --color=auto'
|
||
```
|
||
|
||
| 别名 | 用途 |
|
||
|------|------|
|
||
| `_` | 快速给命令加 `sudo` 前缀 |
|
||
| `gc1` | 浅克隆并递归拉取子模块 |
|
||
| `md` | 创建多级目录 |
|
||
| `rd` | 删除空目录 |
|
||
| `afind` | 用 `ack` 搜索包含关键词的文件 |
|
||
| `grep` 系列 | 默认开启彩色输出 |
|
||
|
||
此外 OMZ 的 `extract` 插件也很省心：不需要记住 `tar.gz`、`zip`、`xz`、`bz2` 等格式分别怎么解压，统一用 `extract` 即可。
|
||
|
||
## 代理开关：为国内网络环境准备
|
||
|
||
```zsh
|
||
alias proxy-on='export http_proxy=http://127.0.0.1:7890 https_proxy=http://127.0.0.1:7890'
|
||
alias proxy-off='unset http_proxy https_proxy'
|
||
```
|
||
|
||
这两个别名适合临时让命令行工具走本地代理，例如拉取 GitHub 仓库、安装依赖、访问国外 API 等。
|
||
|
||
```bash
|
||
proxy-on
|
||
# 执行需要代理的命令
|
||
proxy-off
|
||
```
|
||
|
||
我没有把代理永久写进环境变量，因为那样容易影响内网服务、容器网络和一些只需要直连的命令。按需开启更可控。
|
||
|
||
## Node 与前端工具链
|
||
|
||
配置末尾还包含 pnpm 和 n 的环境变量：
|
||
|
||
```zsh
|
||
export PNPM_HOME="/root/.local/share/pnpm"
|
||
case ":$PATH:" in
|
||
*":$PNPM_HOME/bin:"*) ;;
|
||
*) export PATH="$PNPM_HOME/bin:$PATH" ;;
|
||
esac
|
||
|
||
export N_PREFIX="$HOME/n"
|
||
[[ :$PATH: == *":$N_PREFIX/bin:"* ]] || PATH+=":$N_PREFIX/bin"
|
||
```
|
||
|
||
这里有两个目的：
|
||
|
||
1. `pnpm` 的全局 bin 目录加入 `PATH`，方便直接运行全局安装的 CLI。
|
||
2. `n` 管理的 Node.js 路径加入 `PATH`，让当前 Shell 使用用户目录下的 Node 版本。
|
||
|
||
如果你也用 pnpm 和 n，建议把它们放在 Shell 配置末尾，避免覆盖前面插件初始化所需的环境。
|
||
|
||
## 依赖清单
|
||
|
||
这套配置推荐安装的依赖如下：
|
||
|
||
| 依赖 | 必需 | 用途 |
|
||
|------|:----:|------|
|
||
| `zsh` | ✅ | Shell 本体 |
|
||
| `git` | ✅ | 安装 zinit、拉取插件 |
|
||
| `zinit` | ✅ | 插件管理器 |
|
||
| `powerlevel10k` | ✅ | Prompt 主题 |
|
||
| Nerd Font | ✅ | 正确显示图标和 powerline 符号 |
|
||
| `eza` | 可选 | 更现代的 `ls` 替代品 |
|
||
| `tree` | 可选 | `eza` 不存在时作为树状列表兜底 |
|
||
| `ack` | 可选 | `afind` 搜索别名 |
|
||
| `yazi` | 可选 | 终端文件管理器 |
|
||
| `kubectl` | 可选 | Kubernetes 补全与别名 |
|
||
| `command-not-found` | 可选 | 命令不存在时提示安装包 |
|
||
| `pnpm` | 可选 | Node 包管理器 |
|
||
| `n` | 可选 | Node 版本管理 |
|
||
|
||
最小安装只需要：`zsh`、`git`、Nerd Font。其他工具可以按需补齐。
|
||
|
||
## 可复用的安装步骤
|
||
|
||
如果要在新机器上复用这套配置，可以按这个流程：
|
||
|
||
```bash
|
||
# 1. 安装基础依赖
|
||
sudo apt update
|
||
sudo apt install -y zsh git
|
||
|
||
# 2. 可选增强工具
|
||
sudo apt install -y tree ack
|
||
|
||
# 3. 安装 eza / yazi / pnpm / n 等工具
|
||
# 不同发行版包名可能不同，可按实际系统调整
|
||
|
||
# 4. 放置配置文件
|
||
cp .zshrc ~/.zshrc
|
||
cp .p10k.zsh ~/.p10k.zsh
|
||
|
||
# 5. 切换默认 Shell
|
||
chsh -s "$(command -v zsh)"
|
||
```
|
||
|
||
首次进入 Zsh 时，配置会自动安装 Zinit，并通过 Zinit 拉取 Powerlevel10k 和插件。
|
||
|
||
## 我的取舍
|
||
|
||
这套配置没有追求“插件越多越好”，而是围绕日常使用做了几个取舍：
|
||
|
||
1. **不完整引入 Oh My Zsh**：只按需加载 OMZ library 和 plugin，减少框架开销。
|
||
2. **Prompt 信息分层**：左侧保留目录与 Git，右侧显示环境上下文。
|
||
3. **增强工具必须有 fallback**：`eza` 不存在就退回 `ls`，避免新机器启动失败。
|
||
4. **代理手动开关**：避免代理污染所有命令。
|
||
5. **插件延迟加载**：把首屏可交互时间放在第一优先级。
|
||
|
||
## 总结
|
||
|
||
我的 Zsh 配置可以概括为：
|
||
|
||
- **Zinit**：负责插件安装、延迟加载和补全 replay。
|
||
- **Powerlevel10k**：提供高信息密度、低干扰的两行 Prompt。
|
||
- **OMZ snippets**：按需复用 Oh My Zsh 的成熟插件生态。
|
||
- **eza / yazi / z / autosuggestions**：提升文件浏览、目录跳转和命令输入效率。
|
||
- **pnpm / n**：补齐前端和 Node.js 开发环境。
|
||
|
||
终端配置是一个长期迭代的系统。最好的配置不是最复杂的配置，而是能让你在每天打开终端时少想一步、少敲几个字、少等几百毫秒的配置。
|