Zeal：离线文档浏览器，你的随身参考图书馆 #
Zeal 是什么？ #
Zeal 是一款离线文档浏览器（Offline Documentation Browser），官方将其定位为“你的个人参考图书馆，可瞬间搜索”（Your personal reference library, searchable in an instant）。
对于开发者而言，查询 API 文档是日常高频动作，但打开浏览器、等待网页加载、忍受广告与网络波动，往往打断编码心流。Zeal 把成百上千套官方技术文档下载到本地，用一个统一的搜索框统一管理，输入关键词即可毫秒级定位到函数、类、参数说明或命令行速查表。目前 Zeal 已提供 981 个 docsets（文档集），涵盖 C/C++、Python、JavaScript、Go、Rust、Docker、Kubernetes、Bootstrap、Django、PostgreSQL 等主流技术栈，并包含大量社区贡献的中文文档与速查表。
Zeal 完全开源免费，最初由 Jerzy Kozera 受 macOS 平台 Dash 的启发而开发，如今由 Oleg Shparber 及社区共同维护，主要面向 Windows、Linux 与 BSD 桌面用户。
Zeal 有哪些亮点特色？ #
- 完全离线，不受网络限制：所有文档集下载到本地后即可离线查阅，在飞机、离线机房、内网隔离环境或网络不稳定时依然能秒开文档，彻底摆脱“查文档先联网”的束缚。
- 海量文档集，一站覆盖 981 个 docsets：从编程语言、Web 框架、数据库、云服务 SDK 到 Blender、Emacs、Vim 等工具的速查表（cheatsheet）一应俱全，官方页面明确标注“Zeal offers 981 docsets”。
- 瞬时可搜索（Searchable in an instant）：统一的搜索入口配合本地索引，输入关键词立即返回结果，并支持按文档集过滤、模糊匹配与快捷键唤起，检索体验远胜浏览器书签与本地 PDF。
- 兼容 Dash 生态的文档格式：Zeal 支持 Dash 的用户贡献文档（user contributed docsets），大量第三方文档可直接复用，文档来源与更新渠道更加丰富。
- 多平台与多种安装方式：Windows 提供 MSI 安装包与便携版（Portable），并支持 Chocolatey、Scoop 包管理器一键安装；Linux 覆盖 AppImage、Debian、Ubuntu PPA、Fedora COPR、Arch、openSUSE、Gentoo、ALT Linux 等；BSD 侧支持 FreeBSD 与 OpenBSD 的 ports/pkg。
- 轻量原生桌面应用：基于 Qt 构建，安装包体积小巧（Windows x64 MSI 约 105 MB，ARM64 MSI 仅约 85 MB），资源占用低，启动迅速，适合长期后台驻留随时唤起。
- 标签页式浏览体验：文档页面以标签页方式组织，支持中键关闭标签、中键新标签打开链接、前进/后退导航，行为接近日常使用的浏览器，降低学习成本。
- 开源免费，社区驱动：项目遵循开源协议，源码托管于 GitHub，任何人都可以参与贡献文档、修复缺陷或构建自己的版本，不存在订阅收费与功能阉割。
免费下载 Zeal #
以下为官方提供的各平台安装包（版本 0.9.1），按需选择对应架构与安装形式，点击链接即可下载。
| 文件名 | 描述 | 大小 | 下载 |
|---|---|---|---|
| Zeal-0.9.1-x86_64.AppImage | Linux 通用自包含包（AppImage），免安装，适用于大多数发行版 | 129.4 MB | 夸克网盘 |
| zeal-0.9.1-portable-windows-arm64.zip | Windows ARM64 便携版压缩包，免安装，配置与文档集存于程序目录 | 102.4 MB | 夸克网盘 |
| zeal-0.9.1-portable-windows-x64.zip | Windows x64 便携版压缩包，免安装，配置与文档集存于程序目录 | 121.7 MB | 夸克网盘 |
| zeal-0.9.1-windows-arm64.msi | Windows ARM64 安装包（MSI），适合常规安装 | 85.4 MB | 夸克网盘 |
| zeal-0.9.1-windows-x64.msi | Windows x64 安装包（MSI），适合常规安装 | 105.2 MB | 夸克网盘 |
提示：官网下载页同时提供 Chocolatey、Scoop 等包管理器安装方式，以及各 Linux 发行版的官方仓库与 AppImage；macOS 用户官方推荐使用 Dash。若需要最新 CI 构建，可前往 GitHub Releases 与 CI 构建历史页面获取。
Zeal 如何使用？ #
Zeal 的使用逻辑非常简单：先下载文档集，再随时搜索查看。
- 启动软件：安装或解压后打开 Zeal，首次进入主界面会看到左侧的文档集列表（Docsets）与顶部的搜索框。
- 下载文档集：点击菜单中的 File → Options → Docsets（或工具栏的文档集管理入口），在可用文档列表中勾选你需要的技术栈（例如 C++、Python、Docker、Bootstrap），点击下载。下载完成后会自动解压并建立索引。
- 搜索文档：在搜索框中输入关键词（如
std::vector、requests.get、docker run），下方会实时列出匹配的条目，支持按文档集筛选、按前缀过滤。 - 浏览与导航：点击搜索结果即可在右侧打开对应文档页；文档以标签页组织，双击边栏或使用中键可关闭标签；中键点击文档内链接可在新标签中打开；使用鼠标侧键或
Alt+←/→可前进后退。 - 个性化设置：在 Options 中可调整快捷键、启动时是否隐藏到托盘、是否随系统启动、界面字体与缩放比例等；便携版用户的所有配置与文档集都保存在程序目录内，方便整体拷贝迁移。
小技巧：为 Zeal 设置一个全局快捷键（可借助系统工具），编码时一键唤起搜索框，查完即关，几乎不打断思路。
Zeal 的常见问题？ #
Zeal 需要联网才能使用吗？ 只有“下载文档集”这一步需要网络连接。文档集下载完成后即可完全离线查阅，非常适合内网环境、差旅与网络受限场景。
Zeal 和 Dash 是什么关系？ Zeal 的灵感来自 macOS 平台的 Dash，是其在 Linux/Windows 上的开源实现。官网在 macOS 平台明确提供“Get Dash for macOS”的引导链接，说明官方并未面向 macOS 发行 Zeal，而是推荐使用 Dash；同时 Zeal 兼容 Dash 的用户贡献文档格式，文档生态互通。
为什么 Zeal 没有 macOS 版本？ 根据官网首页与下载页，Zeal 的官方下载仅覆盖 Windows 与各类 Linux 发行版（以及 BSD），macOS 入口指向 Dash。因此 Mac 用户如需同类体验，应使用 Dash。
文档集太多会不会占用大量磁盘空间？ 每个文档集体积从几 MB 到上百 MB 不等，建议只下载当前项目需要的技术栈，并在文档集管理界面中随时删除不再使用的条目以释放空间。
搜索不到想要的内容怎么办？ 首先确认对应文档集已完整下载并解压完成；其次检查是否在搜索框误设置了文档集过滤条件；若该技术官方未提供文档集，可尝试在 Dash 的第三方贡献文档库中查找同名 docset 并手动导入（参考社区常见反馈）。
安装包下载速度慢或链接失效怎么办？ 官网推荐从 GitHub Releases 获取官方二进制包，同时提供 Chocolatey、Scoop 与各 Linux 仓库的安装渠道。若直连速度不理想，可使用上表中的网盘镜像获取对应安装包。
Zeal 是否收费？有没有专业版？ Zeal 是开源免费软件，官网未提供任何付费版本、订阅或内购项，也不存在功能限制版本（参考官网及项目博客说明）。
Zeal 如何安装？ #
Windows #
- MSI 安装（推荐）：下载
zeal-0.9.1-windows-x64.msi（或 arm64 版本），双击运行安装向导，按提示完成安装，之后从开始菜单启动 Zeal。 静默安装可参考 MSI 通用参数：msiexec /i zeal-0.9.1-windows-x64.msi /qn。 - 便携版（Portable）：下载
zeal-0.9.1-portable-windows-x64.zip（或 arm64 版本），解压到任意目录，直接运行目录内的可执行文件即可。该版本的所有设置与文档集都保存在应用目录中，删除目录即完成卸载。 - Chocolatey：先安装 Chocolatey，然后执行
choco install zeal；如需便携版，执行choco install zeal.portable。 - Scoop：先启用 extras 仓库
scoop bucket add extras，再执行scoop install zeal；如有需要可一并安装scoop install vcredist2015。
Linux #
- AppImage（通用）：下载
Zeal-0.9.1-x86_64.AppImage，先赋予可执行权限chmod +x Zeal-0.9.1-x86_64.AppImage，然后直接运行该文件。 - Debian / Ubuntu：
sudo apt install zeal；若官方仓库版本过旧，可添加 PPA：sudo add-apt-repository ppa:zealdocs && sudo apt install zeal（尝鲜可用ppa:zealdocs/nightly）。 - Fedora / RHEL 系：
sudo dnf install zeal；RHEL/CentOS Stream/AlmaLinux/Rocky 需先启用 EPEL，再启用 COPR：sudo dnf copr enable @zealdocs/zeal && sudo dnf install zeal。 - Arch Linux：
sudo pacman -Syu zeal，或从 AUR 安装zeal-git获取开发版。 - openSUSE / Gentoo / ALT Linux / Slackware：分别通过官方仓库、
emerge app-text/zeal、apt-get install zeal、SlackBuilds.org 完成安装。
BSD #
- FreeBSD：源码安装
cd /usr/ports/devel/zeal/ && make install clean，或二进制包pkg install zeal。 - OpenBSD：
doas pkg_add zeal。
从源码构建 #
完整源码托管于 GitHub，按照仓库 README.md 中的说明配置 Qt 等依赖后即可自行编译安装，适合需要定制或跟进最新特性的用户。
Zeal 如何卸载？ #
Windows #
- MSI 安装版：打开「设置 → 应用 → 已安装的应用」（或控制面板的「程序和功能」），找到 Zeal 并点击卸载；也可使用命令行
msiexec /x zeal-0.9.1-windows-x64.msi。 - 便携版：直接删除解压出来的整个文件夹即可，不会在系统中留下安装记录。
- 包管理器安装：Chocolatey 执行
choco uninstall zeal，Scoop 执行scoop uninstall zeal。 - 残留清理：如需彻底清除，可手动删除用户配置目录下的 Zeal 文件夹（通常位于
%APPDATA%\Zeal与%LOCALAPPDATA%\Zeal），其中包含个人设置、搜索历史与已下载的文档集，删除后下次安装需重新下载文档集。
Linux #
- Debian / Ubuntu：
sudo apt remove zeal，如需连同配置一并删除可执行sudo apt purge zeal。 - Fedora / RHEL 系：
sudo dnf remove zeal。 - Arch Linux：
sudo pacman -Rns zeal（AUR 版本用yay -Rns zeal-git或对应助手命令）。 - Gentoo：
emerge --unmerge app-text/zeal。 - AppImage：直接删除
.AppImage文件即可，无需卸载流程。 - 残留清理：用户级配置与文档集通常位于
~/.local/share/Zeal和~/.config/Zeal，若希望彻底清理，可在卸载后手动删除这两个目录。
BSD #
- FreeBSD：若通过 ports 安装，进入源码目录执行
make deinstall clean；若通过包安装，执行pkg delete zeal。 - OpenBSD：执行
doas pkg_delete zeal。
卸载提醒：Zeal 的文档集体积可能较大（数百 MB 至数 GB），如果你计划重新安装，可先备份 docsets 目录，避免重复下载耗费时间与流量。