跳到主要内容

⚡️ 安装

快速开始

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

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

使用 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

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

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

手动设置

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

typeset -Ag ZI
typeset -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 ZI
ZI[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'

Zi 模块: zpmod

信息

用法:

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

状态页

安装器

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

加载器

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