⚡️ 安装
自动安装
- 校验 lib/sh/install.sh 文件的 sha256 checksum
- If required append -b <tag> or -b <branch> e.g:
sh -c "$(curl -fsSL get.zshell.dev)" -- -i skip -b main
- Minimal
- Loader
- Repository
- Annex
- ZUnit
仅安装zi本体然后将自动添加最小化配置到 .zshrc 文件:
sh -c "$(curl -fsSL get.zshell.dev)" --
用 loader 最小化安装并加载：
sh -c "$(curl -fsSL get.zshell.dev)" -- -a loader
The installer will download the loader and add the snippet below to the .zshrc file.
if [[ -r "${XDG_CONFIG_HOME:-${HOME}/.config}/zi/init.zsh" ]]; then
source "${XDG_CONFIG_HOME:-${HOME}/.config}/zi/init.zsh" && zzinit
fi
然后重新加载 shell 使用：exec zsh。 全部完成了！
使用默认值或 自定义 值克隆版本库：
sh -c "$(curl -fsSL get.zshell.dev)" -- -i skip
安装包含最小化配置与被推荐的 annexes ：
sh -c "$(curl -fsSL get.zshell.dev)" -- -a annex
安装包含最小化配置与被推荐的 annexes 和 zdharma/zunit：
sh -c "$(curl -fsSL get.zshell.dev)" -- -a zunit
手动安装
Prepare
Set up the install location and create a directory:
typeset -Ag ZI
typeset -gx ZI[HOME_DIR]="${HOME}/.zi"
typeset -gx ZI[BIN_DIR]="${HOME}/.zi/bin"
command mkdir -p "$ZI[BIN_DIR]"
For security reasons run function compaudit to check if the completion system would use files owned by root or by the current user, or files in directories that are world or group-writable.
If failed, then set the current user as the owner of directories, then remove group/others write permissions, and clone the repository:
compaudit | xargs chown -R "$(whoami)" "$ZI[HOME_DIR]"
compaudit | xargs chmod -R go-w "$ZI[HOME_DIR]"
command git clone https://github.com/z-shell/zi.git "$ZI[BIN_DIR]"
Enable
要启用 Zi，将以下代码段放入 .zshrc 以加载先前安装目录中的 zi.zsh 文件：
typeset -A ZI
ZI[BIN_DIR]="${HOME}/.zi/bin"
source "${ZI[BIN_DIR]}/zi.zsh"
Completions
Enable Zi completions by placing the following snippet in the .zshrc file:
The snippet below must be placed after after enabling Zi.
autoload -Uz _zi
(( ${+_comps} )) && _comps[zi]=_zi
安装之后
全新安装后，建议使用以下命令重新加载 shell 并重新编译 Zi：
- exec zsh -il
- zi self-update
运行 zi -h 获取可用命令或 探索 wiki 去 扩展, 自定义 和 创建插件 👍 🎉。
如果您有任何问题或需要帮助 🤦♂️，让我们在 Github 上讨论或打开一个问题。
这有助于我们改进和完善 Zi。 Don't forget to help the project: share, contribute, or translate 🌐 🥰 🤓.
让我们粘合一个适合自己的工具链 🚀。
有想法吗？
在 playground 提出建议或请求
sh -c "$(curl -fsSL get.zshell.dev)" -- -a ???
需要热身吗？
Docker Alpine
docker run --rm -it ghcr.io/z-shell/zd:latest
Turbo Zi in Docker
如果您创建使用 Zi 的 Docker 映像，请在 shell 开始交互之前安装 Turbo-loaded 插件，以 @zi-scheduler 这样的方式使用函数：
- 无需等待提示即可安装插件（i.e，对脚本友好）。
- 立即安装所有插件，无需考虑 wait 参数。
为此，请使用 burst 参数并调用 @zi-scheduler 函数：
RUN zsh -i -c -- '@zi-scheduler burst || true'
- 示例： Dockerfile
- 实操： Playground
Zi 模块：zpmod
该模块以透明方式自动编译源脚本，并列出所有源文件，在左侧标明 source 耗时（以毫秒为单位）。
可用链接
Installer
| 服务 | URL |
|---|---|
| Git.io | https://git.io/get-zi |
| GitHub RAW | https://raw.githubusercontent.com/z-shell/zi-src/main/lib/sh/install.sh |
Loader
| 服务 | URL |
|---|---|
| Git.io | https://git.io/zi-loader |
| GitHub RAW | https://raw.githubusercontent.com/z-shell/zi-src/main/lib/zsh/init.zsh |