166 Zeal —— 把开发文档下载到本地,断网也能随手查

一句话定位:Zeal 是一款开源的离线文档浏览器,可以把几百种编程语言和框架的官方文档整包下载到本地,写代码时按下快捷键随手查,不需要浏览器,也不需要网络。

它解决什么麻烦

写代码时查文档是高频动作:一个函数的参数、一个 CSS 属性的兼容性、一个命令的选项。常规做法是开浏览器搜索,结果要忍受广告、SEO 垃圾站和层层跳转,网不好时更是干等。文档版本还经常对不上——项目用的是 Python 3.10,搜索引擎给的是 3.13 的新语法,越查越乱。Zeal 的思路是把官方文档整包下载成本地数据,查询在毫秒级完成,版本自选,断网照用。

核心能力

  • 内置几百个文档包:Python、JavaScript、C++、Go、Rust、Django、React、MySQL、Redis 等主流技术栈基本全覆盖
  • 快捷键全局唤起,输入即搜,结果按章节分组,回车直达对应条目
  • 多个文档包可同时搜索,前端一次查 HTML、CSS、JS 三份文档不用切来切去
  • 兼容 Dash(macOS 同类鼻祖)的文档格式,社区自制的文档包也能导入

实测体验

Windows 安装包 40 MB 左右,装好后在设置里勾选需要的文档,Python 3 文档约 40 MB,一分钟下完。日常工作流变成:光标停在函数名上,按全局快捷键,输入函数名,回车——从起念到看到文档不到三秒,比开浏览器搜索快一个数量级。断网在高铁上写代码时,它更是实实在在救过命。文档默认缓存放在用户目录下,换电脑时把缓存目录拷走,几分钟就能在新机器上恢复整套文档库。多文档联合搜索的表现也好,输入 flex 直出 CSS 的属性页和用法说明,上下键切换即可。缺点也明显:搜索只做标题匹配,没有全文检索,文档内的关键词得靠 Ctrl+F 二次定位,个别冷门框架没有现成文档包。不过项目支持自己制作文档包,社区里也常有现成方案,真缺哪个可以自己动手补上。

适合谁

  • 每天写代码、频繁查 API 的开发者,效率提升立竿见影
  • 经常在地铁、高铁、飞机上办公的人,离线能力就是刚需
  • 喜欢键盘流、讨厌浏览器里开十个文档标签的人
  • 同时维护多个语言技术栈的全栈开发者,文档版本跟着项目走最省心

需要注意的地方

文档靠整包更新,框架迭代快的时候要记得手动点一下刷新;它只适合查参考手册,不适合找教程;索引常驻内存,8 GB 内存的机器可以放心用,配置更低的机器建议只保留常用的几个文档包。

小结

Zeal 把「查文档」从一次网络冒险变成一次本地秒查。免费、开源、轻量,是开发者工具箱里性价比极高的一件装备。装上它,然后把浏览器里那排文档标签页关掉吧。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部