Prezto — 即时强大的 Zsh 配置框架

安装指南

手动安装

Prezto 适用于任何最新的 Zsh 版本，但最低要求的版本是 4.3.11。

1. 启动 Zsh：

   zsh
   

2. 克隆仓库：

   git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
   

   可选：安装在 $XDG_CONFIG_HOME 中

   如果你已经配置了 $XDG_CONFIG_HOME（通常默认为 $HOME/.config）并且希望将 Prezto 安装在 $XDG_CONFIG_HOME/zsh 下，可以按照以下步骤操作：

   • 克隆仓库：

     git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-${XDG_CONFIG_HOME:-$HOME/.config}/zsh}/.zprezto"
     

   • 在 $HOME/.zshenv 中配置 $XDG_CONFIG_HOME 和 $ZDOTDIR：

     export XDG_CONFIG_HOME="${XDG_CONFIG_HOME:=$HOME/.config}"
     [[ -d $XDG_CONFIG_HOME/zsh ]] && export ZDOTDIR="$XDG_CONFIG_HOME/zsh"
     source "$ZDOTDIR/.zshenv"
     

3. 创建新的 Zsh 配置文件，通过复制/链接提供的 Zsh 配置文件：

   setopt EXTENDED_GLOB
   for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
     ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
   done
   

   注意： 如果你已经有任何给定的配置文件，ln 操作将会导致错误。在简单情况下，你可以通过在 $HOME/.zshrc 底部添加 source "${ZDOTDIR:-$HOME}/.zprezto/init.zsh" 来加载 Prezto，并保留其余的 Zsh 配置。对于更复杂的设置，建议备份原始配置文件并替换为 Prezto 提供的 runcoms。

4. 将 Zsh 设置为默认 shell：

   chsh -s /bin/zsh
   

5. 打开一个新的 Zsh 终端窗口或标签页。

故障排除

如果你在切换到 Prezto 后无法找到某些命令，请修改 $HOME/.zprofile 中的 PATH 变量，然后打开一个新的 Zsh 终端窗口或标签页。

项目使用说明

Prezto 有许多默认禁用的功能。阅读源代码和附带的 README 文件以了解可用功能。

模块

1. 浏览 modules 以查看可用模块。
2. 在 $HOME/.zpreztorc 中加载所需的模块，然后打开一个新的 Zsh 终端窗口或标签页。

主题

1. 输入 prompt -l 查看可用主题列表。

2. 输入 prompt -p name 预览主题。

3. 在 $HOME/.zpreztorc 中加载你喜欢的主题，然后打开一个新的 Zsh 终端窗口或标签页。

   注意： git 模块可能需要特殊符号（如上图右侧的符号）。在 $HOME/.zpreztorc 中添加 'git' 到 pmodule 列表以启用此模块。

外部模块

1. 默认情况下，模块将从 /modules 和 /contrib 加载。

2. 可以在 $HOME/.zpreztorc 中添加额外的模块目录到 :prezto:load:pmodule-dirs 设置。

   注意： 模块名称需要唯一，否则在加载时会导致错误。

   zstyle ':prezto:load' pmodule-dirs $HOME/.zprezto-contrib
   

项目 API 使用文档

Prezto 本身没有传统意义上的 API，但它通过模块和配置文件提供了丰富的功能和自定义选项。以下是一些关键的配置和使用方式：

模块加载

在 $HOME/.zpreztorc 中，你可以通过以下方式加载模块：

zstyle ':prezto:load' pmodule 'module1' 'module2'

主题设置

在 $HOME/.zpreztorc 中，你可以通过以下方式设置主题：

zstyle ':prezto:module:prompt' theme 'theme_name'

自定义配置

你可以通过修改 $HOME/.zpreztorc 文件来添加自定义配置，例如：

zstyle ':prezto:module:editor' key-bindings 'emacs'

项目安装方式

Prezto 的安装方式主要有两种：

1. 手动安装：按照上述步骤手动克隆仓库并配置。

2. 自动更新：通过运行 zprezto-update 命令自动检查并更新 Prezto。

   zprezto-update
   

   如果有文件冲突，你需要手动进入 $ZPREZTODIR 目录并解决冲突。

   手动更新：

   cd $ZPREZTODIR
   git pull
   git submodule sync --recursive
   git submodule update --init --recursive
   

通过以上步骤，你可以轻松安装、配置和使用 Prezto，享受更强大的 Zsh 命令行环境。