Zi

管理你的 Zsh 插件、代码片段和命令行工具。

快速开始  ·  文档  ·  版本发布  ·  讨论

Zi 是 Z-Shell 生态系统的插件管理器，前身为 zplugin 和 zinit。

功能特性

• 快速启动： 通过 Turbo 模式将插件加载推迟到首次提示符之后。
• 灵活的来源： 加载插件、脚本、补全和发布产物。
• 加载控制： 使用 ice 修饰符配置下载、构建和更新。
• 工具管理： 无需 root 权限即可安装命令行工具。
• 扩展： 通过 Zi annexes 添加功能。

环境要求

使用 Zsh，并确保 Git 在 PATH 中可用。快速开始安装程序还需要 curl 和一个 POSIX shell。你安装的插件和工具可能有各自的依赖项。

快速开始

1. 安装 Zi

官方安装程序会使用默认加载器配置安装 Zi，并向 .zshrc 添加一条简短的管理源条目（参见官方安装页面）：

sh -c "$(curl -fsSL get.zshell.dev)" --

[!IMPORTANT] 在运行远程安装脚本之前，请查看安装程序源码及其发布的 SHA-256 校验和。

2. 添加你的第一个插件

在安装程序的管理源条目之后，将以下命令添加到 .zshrc。此示例加载一个 Oh My Zsh 代码片段、命令建议和快速语法高亮：

# ~/.zshrc
zi snippet OMZ::plugins/git/git.plugin.zsh
zi light zsh-users/zsh-autosuggestions
zi light z-shell/F-Sy-H

snippet 加载独立脚本。light 加载插件。首次加载时会下载任何缺失的仓库或代码片段。

3. 重新加载 Zsh

exec zsh -il

运行 zi -h 以探索可用命令。有关其他安装程序、手动设置、补全和安装后步骤，请参阅完整的安装指南。

按任务学习

• 加载插件和代码片段： 总体概述。
• 选择依赖项的加载方式： ice 修饰符。
• 配置路径和行为： 配置指南。
• 更新、检查和卸载： 命令参考。
• 查找插件和 annexes： 生态系统目录。
• 了解 shell 启动过程： 官方 Zsh 启动文件参考。

对于自动化安装程序和终端界面，请使用设置集成契约，包括计划/应用阶段、结果和事件处理。

社区与支持

• 在 Z-Shell Discussions 中提出使用问题。
• 通过 Zi issues 报告可复现的缺陷。
• 在版本发布页面浏览版本和更新日志。
• 探索更广泛的 Z-Shell 组织。

贡献

欢迎贡献。在提交 issue 或 pull request 之前，请阅读贡献指南以了解分支模型和发布流程。查看 Zsh 工作流以了解用于验证检出内容的语法和针对性回归检查。开发工作以 next 分支为目标，而 main 包含生产版本。

安全

请遵循 Z-Shell 安全政策以私下报告漏洞。在修复可用之前，请勿在公开 issue 中披露漏洞。

许可证

Zi 在 MIT 许可证下提供。