跳到主要内容

Oh My Zsh配置

Oh My Zsh是一个强大的Zsh框架,提供丰富的插件和主题配置,提升终端使用体验。

安装Oh My Zsh​

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

安装完成后,Zsh会自动成为默认Shell。

配置备份与恢复​

备份位置​

Oh My Zsh 安装时会自动备份原有的配置文件:

  • ~/.zshrc → ~/.zshrc.pre-oh-my-zsh

恢复原有配置​

如果安装 Oh My Zsh 后发现之前的配置(如 NVM、SDKMAN 等)丢失,可以按照以下步骤恢复:

  1. 查看备份文件内容
cat ~/.zshrc.pre-oh-my-zsh
  1. 将备份配置添加到新的 .zshrc

编辑 ~/.zshrc,在文件末尾添加备份文件中的配置(通常包括 NVM、SDKMAN 等环境配置):

# 示例:从备份文件中添加 NVM 和 SDKMAN 配置
# NVM 配置
export NVM_DIR="$HOME/.nvm"
[ -s "$(brew --prefix)/opt/nvm/nvm.sh" ] && . "$(brew --prefix)/opt/nvm/nvm.sh"

# SDKMAN 配置(必须在文件末尾)
export SDKMAN_DIR="$HOME/.sdkman"
[[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"
  1. 重新加载配置
source ~/.zshrc

注意:

  • 不要完全替换 .zshrc,而是将备份文件中的个人配置追加到 Oh My Zsh 配置的末尾
  • SDKMAN 的配置必须放在 .zshrc 文件的最末尾
  • 建议在修改前先备份当前的配置文件

配置主题​

查看内置主题​

Oh My Zsh内置了丰富的主题,可以在 ~/.oh-my-zsh/themes/ 目录下查看所有可用主题。

更换内置主题​

编辑配置文件:

nano ~/.zshrc

找到 ZSH_THEME 配置项,修改为主题名称:

ZSH_THEME="robbyrussell" # 默认主题
# 或者尝试其他内置主题
ZSH_THEME="agnoster"
ZSH_THEME="powerline"
ZSH_THEME="bira"

保存后重新加载配置:

source ~/.zshrc

安装Powerlevel10k主题​

Powerlevel10k是目前最流行的Oh My Zsh主题,速度快、显示信息丰富。

克隆主题仓库​

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

配置主题​

编辑 ~/.zshrc,设置主题为 Powerlevel10k:

ZSH_THEME="powerlevel10k/powerlevel10k"

配置向导​

重新加载配置后,Powerlevel10k会自动启动配置向导:

source ~/.zshrc

按照向导提示选择合适的样式,包括:

  • 图标样式(ASCII/Unicode)
  • 提示符颜色
  • 时间显示
  • 目录显示模式
  • Git状态显示

重新配置​

如果需要重新配置Powerlevel10k,运行:

p10k configure

安装常用插件​

查看内置插件​

所有内置插件位于 ~/.oh-my-zsh/plugins/ 目录。

启用内置插件​

编辑 ~/.zshrc,在 plugins=(...) 部分添加插件:

plugins=(
git
zsh-autosuggestions
zsh-syntax-highlighting
z
sudo
)

常用插件说明​

  • git: Git命令补全和别名
  • z: 快速跳转到常用目录
  • sudo: 双击ESC快速添加sudo
  • extract: 统一解压命令

安装外部插件​

zsh-autosuggestions(自动补全建议)​

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

zsh-syntax-highlighting(语法高亮)​

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

配置完成后重新加载:

source ~/.zshrc

常用配置​

历史记录配置​

编辑 ~/.zshrc,添加以下配置:

# 历史记录保存数量
HISTSIZE=10000
SAVEHIST=10000

# 历史记录文件
HISTFILE=~/.zsh_history

# 不记录重复命令
setopt HIST_IGNORE_DUPS

# 不记录以空格开头的命令
setopt HIST_IGNORE_SPACE

别名配置​

在 ~/.zshrc 中添加常用别名:

# 文件操作
alias ll='ls -alF'
alias la='ls -A'
alias l='ls -CF'

# Git别名
alias gs='git status'
alias ga='git add'
alias gc='git commit'
alias gp='git push'
alias gl='git log --oneline --graph --decorate'

# Docker别名
alias dps='docker ps'
alias dpsa='docker ps -a'
alias di='docker images'
alias dex='docker exec -it'

环境变量配置​

# 编辑器
export EDITOR=nano
export VISUAL=nano

# 语言设置
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8

解决终端图标显示问题​

某些主题(如 Powerlevel10k)使用特殊图标字符,在 VSCode 或 JetBrains 等编辑器的终端中可能无法正常显示。

问题验证​

在终端中执行以下命令测试:

echo $'\uf179 \uf07c \uf418 \ue0b0'

如果显示的是乱码或方框,需要安装 Nerd Font 字体。

安装 Nerd Font 字体​

推荐使用 Meslo 字体(与 iTerm2 和 Oh My Zsh 官方示例同族,视觉协调)。

homebrew/cask-fonts 已废弃并清空,字体 cask 已并入 homebrew/cask。不要再执行 brew tap homebrew/cask-fonts。

macOS​

brew install --cask font-meslo-lg-nerd-font

安装完成后,字体册中会出现 MesloLGS NF / MesloLGM Nerd Font 等条目。

Linux(Debian)​

Linuxbrew 同样能装这个 cask,TTF 会落到用户字体目录 ~/.local/share/fonts/。cask 从 GitHub Releases 下载 Meslo.tar.xz,国内通常无法直连,需要先配置 HTTP 代理:

export http_proxy="http://<proxy-host>:<port>"
export https_proxy="$http_proxy"

HOMEBREW_NO_AUTO_UPDATE=1 brew install --cask font-meslo-lg-nerd-font
fc-cache -fv ~/.local/share/fonts
fc-list : family | grep -i 'MesloLGM Nerd Font'

代理地址按本机环境填写,可参考 Debian 代理配置。未开代理时常见失败:

Error: Download failed on Cask 'font-meslo-lg-nerd-font'
curl: (7) Failed to connect to github.com port 443

验证通过时应能看到 MesloLGM Nerd Font、MesloLGS Nerd Font 等 family。

不用 Homebrew 时,手动下载解压即可:

mkdir -p ~/.local/share/fonts
cd /tmp
curl -fL -o Meslo.tar.xz \
https://github.com/ryanoasis/nerd-fonts/releases/latest/download/Meslo.tar.xz
tar -xJf Meslo.tar.xz -C ~/.local/share/fonts --wildcards '*.ttf'
fc-cache -fv ~/.local/share/fonts
fc-list : family | grep -i 'MesloLGM Nerd Font'

Linux 系统终端(GNOME Terminal)还要把配置文件字体改成 MesloLGM Nerd Font:汉堡菜单 → 偏好设置 → 配置文件 → 自定义字体。

VSCode 配置​

在设置中搜索 terminal.integrated.fontFamily,修改为:

MesloLGM Nerd Font

保存后重启 VSCode 终端,图标即可正常显示。

JetBrains 系列配置​

  • 打开 Preferences → Editor → Font
  • 取消勾选 Use console font
  • 将 Console Font 设置为 MesloLGM Nerd Font
  • 点击 Apply & Restart

验证​

在终端执行:

echo $'\uf179 \uf07c \uf418 \ue0b0'

能看到苹果、文件夹、Git 分支图标和三角形,即表示 Nerd Font 已生效。然后运行:

omz reload

左侧提示符的图标会正常显示。

切换回Bash​

如果需要切换回Bash:

chsh -s /bin/bash

切换到Zsh:

chsh -s /bin/zsh

卸载Oh My Zsh​

运行卸载脚本:

uninstall_oh_my_zsh

参考资料​