⚡️ 安装

快速开始

将以下内容添加到 .zshrc 文件中：

Instant

~/.zshrc

source <(curl -sL git.io/zi-loader); zzinit

Verified

验证文件的 sha256 checksum：lib/zsh/init.zsh:

~/.zshrc

local cs_ok='7fab1ecb8d2ffbdb4aa98dd1e51cebaeaa4d8137e1de11938f3e0df24af262bb'local cs=$(sha256sum <(curl -sL git.io/zi-loader) | awk '{print $1}')[[ $cs_ok == $cs ]] && { source <(curl -sL git.io/zi-loader); zzinit; } || {  print -P "%F{160}▓▒░ Houston, we have a problem, the %F{226}$cs%F{160} do not match\!%f%b"; exit 1}

使用 exec zsh 重新加载 shell 并运行 zi -h 以获取使用信息。

自动设置

提示

• 验证文件： lib/sh/install.sh 的 sha256 校验和
• 如果需要，请添加 -b <tag> 或 -b <branch> ，例如：

sh -c "$(curl -fsSL git.io/get-zi)" -- -i skip -b main

Minimal

安装并向 .zshrc 添加最小配置：

sh -c "$(curl -fsSL git.io/get-zi)" --

Loader

使用 loader 安装并包含最小配置：

sh -c "$(curl -fsSL git.io/get-zi)" -- -a loader

安装程序将下载加载器并将下面的代码段添加到 .zshrc 文件中。

if [[ -r "${XDG_CONFIG_HOME:-${HOME}/.config}/zi/init.zsh" ]]; then  source "${XDG_CONFIG_HOME:-${HOME}/.config}/zi/init.zsh" && zzinitfi

提示

The loader can be manually fetched from available links to any location on the system, and sourced from .zshrc or as shown in the quick-setup.

然后用 exec zsh 重新加载 shell。 全部完成了！

Repository

使用默认值或如果设置 自定义 值克隆储存库。

sh -c "$(curl -fsSL git.io/get-zi)" -- -i skip

Annex

使用最小化配置和推荐的 附件 安装:

sh -c "$(curl -fsSL git.io/get-zi)" -- -a annex

ZUnit

使用最小化配置，安装推荐的 附件 ，并配置 zdharma/zunit:

sh -c "$(curl -fsSL git.io/get-zi)" -- -a zunit

手动设置

相关内容

• 🏗 Configuration management

设置安装位置并创建目录：

typeset -Ag ZItypeset -gx ZI[HOME_DIR]="${HOME}/.zi" ZI[BIN_DIR]="${ZI[HOME_DIR]}/bin"command mkdir -p "$ZI[BIN_DIR]"

出于安全原因，运行函数 compaudit 来检查 完成系统 是否会使用不属于 root 或 当前用户的文件，抑或是位于可以被 所有用户 或 组可写目录中的文件。

如果失败，则将当前用户设置为目录的所有者，然后删除 group/others 的写入权限，并克隆存储库：

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]"

要启用 Zi，请从先前设置的目录中 source zi.zsh ，将以下代码段放入 .zshrc 文件中：

~/.zshrc

typeset -A ZIZI[BIN_DIR]="${HOME}/.zi/bin"source "${ZI[BIN_DIR]}/zi.zsh"

警告

下面的两行必须放在上面的行之后，即在启用 Zi 之后。

启用 Zi 补全：

~/.zshrc

autoload -Uz _zi(( ${+_comps} )) && _comps[zi]=_zi

安装后操作

全新安装后，建议使用 exec zsh 重新加载 shell 并使用 zi self-update 编译 Zi。 运行 zi -h 以查看所有可用命令。 了解 Zi 功能和性能，或通过浏览 wiki 开始。

如果您有任何问题或需要帮助 🤦‍♂️，让我们在 此处讨论 或以任何语言打开一个 问题。

它帮助我们改进并让 Zi 变得更好。 不要忘记帮助项目：分享、贡献或 翻译 🌐 🥰 🤓。

让我们一起抓住一切，创建一个为我们服务的工具链 🚀。

有想法？

 在  playground 建议或请求

sh -c "$(curl -fsSL git.io/get-zi)" -- -a ???

 需要热身？

 Alpine Docker

docker run --rm -it ghcr.io/z-shell/zd:latest

Docker 中的 Turbo Zi

如果您创建使用 Zi 的 Docker 映像，请在 shell 开始交互之前安装 Turbo-loaded 插件，以这样的方式使用 @zi-scheduler 函数：

• 无需等待提示即可安装插件（即，对脚本友好）。
• 立即安装所有插件，无需考虑 wait 参数。

为此，请使用 burst 参数并调用 @zi-scheduler 函数：

RUN zsh -i -c -- '@zi-scheduler burst || true'

• 一个例子： Dockerfile
• 实际例子： Playground

Zi 模块： zpmod

信息

• 所需的 Zsh 版本： >= v5.8.0
•  z-shell/zpmod

With Zi

用法：

zi module {build|info|help} [options]zi module build [--clean]zi module info [--link]

• 要开始使用 Zi Zsh 模块，请运行：zi module build。 附加 --clean 以运行 make distclean。
• 要加载模块的时候显示模块说明，请运行：zi module info。
• 要启用来自模块集的调试消息：

typeset -g ZI_MOD_DEBUG=1

Standalone

sh -c "$(curl -fsSL git.io/get-zi)" -- -a zpmod

可用的链接

状态页 ✅

安装器

服务	URL
带重定向	https://get.zshell.dev
IPFS	https://ipfs.zshell.dev/sh/install.sh
不带重定向 （直链）	https://raw.githubusercontent.com/z-shell/zi-src/main/lib/sh/install.sh

加载器

服务	URL
带重定向	https://init.zshell.dev
IPFS	https://ipfs.zshell.dev/zsh/init.zsh
不带重定向 （直链）	https://raw.githubusercontent.com/z-shell/zi-src/main/lib/zsh/init.zsh