YANG's Notes

Appearance

ZSH 常用插件 ​

Commit message: docs: add comprehensive guide for ZSH plugins and themes

This commit adds a detailed guide covering:

  • Installation methods for Oh-My-ZSH (online and offline)
  • Plugin management and configuration
  • Popular plugins like zsh-autosuggestions, zsh-syntax-highlighting, extract, etc.
  • Theme recommendations including starship and Powerlevel10k
  • Font recommendations for proper icon display

安装 Oh-My-ZSH

在线安装

https://ohmyz.sh/#install

bash
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
# 国内镜像
# REMOTE=https://gitee.com/mirrors/oh-my-zsh sh -c "$(curl -fsSL https://gitee.com/mirrors/oh-my-zsh/raw/master/tools/install.sh)"

离线安装：

https://github.com/ohmyzsh/ohmyzsh/issues/9415

  1. 下载最新版本release (https://github.com/ohmyzsh/ohmyzsh)
  2. 上传并解压到 ~/.oh-my-zsh
  3. cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc

1. 启用插件的方法 ​

打开~/.zshrc文件找到plugins，然后加入要开启的插件名称。

bash
plugins = (
  git
  zsh-autosuggestions
  zsh-syntax-highlighting
  conda-zsh-completion
  poetry
)

执行source ~/.zshrc使其生效。

2. 推荐插件 ​

zsh-autosuggestions ​

命令自动补全

https://github.com/zsh-users/zsh-autosuggestions

bash
git clone https://github.com/zsh-users/zsh-autosuggestions.git $ZSH_CUSTOM/plugins/zsh-autosuggestions
# 国内镜像
# git clone https://gitee.com/mirrors/zsh-autosuggestions.git $ZSH_CUSTOM/plugins/zsh-autosuggestions

zsh-syntax-highlighting ​

命令语法高亮插件

https://github.com/zsh-users/zsh-syntax-highlighting

bash
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git $ZSH_CUSTOM/plugins/zsh-syntax-highlighting
# 国内镜像
# git clone https://gitee.com/mirrors/zsh-syntax-highlighting.git $ZSH_CUSTOM/plugins/zsh-syntax-highlighting

extract ​

内置插件。智能判断压缩包后缀来选择解压命令。

bash
extract 文件名
# 或者 x 文件名

themes ​

内置插件。快速切换主题。

bash
theme 主题名

conda-zsh-completion ​

conda命令补全。

https://github.com/conda-incubator/conda-zsh-completion

安装：

bash
git clone https://github.com/conda-incubator/conda-zsh-completion.git ${ZSH_CUSTOM:=~/.oh-my-zsh/custom}/plugins/conda-zsh-completion

启用：

修改.zshrc，启动插件，并重新加载compinit

bash
# 将 conda-zsh-completion 加入到插件列表, 追加到最后
plugins=(git conda-zsh-completion)
# 这句放到脚本末
autoload -U compinit && compinit

附注：在zsh上自动初始化conda的配置

bash
conda init zsh

zoxide ​

zoxide 是一款高效的目录跳转工具，基于目录访问频率进行智能匹配，极大提升工作效率。

https://github.com/ajeetdsouza/zoxide

安装：

bash
curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
# 或者使用 cargo 安装
# cargo install zoxide --locked
# 或者 MacOS 使用 brew 安装
# brew install zoxide

启用：

bash
eval "$(zoxide init zsh)"

使用方法：

bash
z foo              # cd into highest ranked directory matching foo
z foo bar          # cd into highest ranked directory matching foo and bar
z foo /            # cd into a subdirectory starting with foo

z ~/foo            # z also works like a regular cd command
z foo/             # cd into relative path
z ..               # cd one level up
z -                # cd into previous directory

zi foo             # cd with interactive selection (using fzf)

z foo<SPACE><TAB>  # show interactive completions (zoxide v0.8.0+, bash 4.4+/fish/zsh only)

zi 依赖 fzf，需要先安装 fzf

bash
brew install fzf

autojump(已用 zoxide 代替) ​

实现目录间快速跳转，想去哪个目录直接 j + 目录名，不用再频繁的 cd 了！

https://github.com/wting/autojump

安装：

bash
git clone https://github.com/wting/autojump.git
cd autojump
python ./install.py
# 卸载
# python ./uninstall.py

启用：

把以下代码加到 ~/.zshrc 尾部

bash
# 使用git安装的
[[ -s ~/.autojump/etc/profile.d/autojump.sh ]] && . ~/.autojump/etc/profile.d/autojump.sh

使用方法：

命令：autojump 或 j

bash
j 目录名

对于权重数据库的访问

bash
# 在数据库中添加一个目录
j -a [dir]
# 提升当前目录value数目的权重
j -i [value]
# 降低当前目录的权重
j -d [value]
# 显示数据库中的统计数据
j -s
# 清除不再需要的目录
j --purge

z(已用 zoxide 代替) ​

内置插件。类似 autojump 。提供一个z命令，在常用目录之间跳转。

bash
z 目录名

如果z插件历史记录太多，并且有一些不是自己想要的，可以删除

bash
z -x 不要的路径

vi-mode ​

内置插件。vim输入模式

safe-paste ​

内置插件。当你往 zsh 粘贴脚本时，它不会被立刻运行。

colored-man-pages ​

内置插件。给man添加色彩。

sudo ​

内置插件。连按两下 Esc 键在命令的开头加上或去掉 sudo 关键字。

docker / docker-compose ​

内置插件。docker 和 docker-compose 命令的自动补全

atuin: shell 历史记录增强 ​

atuin

Installation | Atuin Docs

bash
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh
# 或者编译安装
# cargo install atuin
# 或者使用 brew 安装
# brew install atuin

atuin import auto

poetry ​

https://python-poetry.org/docs/#oh-my-zsh

bash
mkdir $ZSH_CUSTOM/plugins/poetry
poetry completions zsh > $ZSH_CUSTOM/plugins/poetry/_poetry

3. 推荐主题 ​

3.1 字体 ​

建议使用 Nerd Fonts 系列字体，否则无法显示大部分icon。

推荐字体：

  • NERD FONTS
  • Maple Mono
    • 建议选 MapleMono-NF-CN 这个版本，支持 Nerd Fonts 和中文等宽显示

3.2 主题：starship ​

3.2.1 安装 ​

https://starship.rs/guide/#🚀-installation

安装:

bash
curl -sS https://starship.rs/install.sh | sh
# 或者使用 cargo 安装
# cargo install starship --locked

3.2.2 配置 ​

在 .zshrc 文件末尾加入如下内容

bash
# starship
# !!! Keep this line at the end of file
if command -v starship &> /dev/null; then
    eval "$(starship init zsh)"
    # Use preset
    if [ ! -f "$HOME/.config/starship.toml" ]; then
        starship preset bracketed-segments -o "$HOME/.config/starship.toml"
    fi
fi
# === Don't add any new lines

主题预设推荐：bracketed-segments

bash
starship preset bracketed-segments -o ~/.config/starship.toml

3.3 主题：Powerlevel10k ​

3.3.1 安装 ​

https://github.com/romkatv/powerlevel10k

bash
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
# 墙内可用gitee镜像代替
# git clone --depth=1 https://gitee.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

在 ~/.zshrc中启用主题

bash
ZSH_THEME="powerlevel10k/powerlevel10k"

3.3.2 配置 ​

配置向导（configuration wizard）

bash
p10k configure

配置储存在~/.p10k.zsh

Released under the MIT License.

Copyright © 2019-present YANG