引言

在日常的开发和系统管理工作中，命令行是不可或缺的工具。然而，随着工具链的日益复杂，记住各种命令及其繁多的选项变得越来越困难。即使是经验丰富的用户，也常常需要查阅文档或搜索网络来回忆某个不常用的命令。navi 就是为了解决这个问题而诞生的一个开源项目，它提供了一种交互式的方式来浏览和执行命令行备忘单。

项目地址: https://github.com/denisidoro/navi

navi 是什么？

navi 是一个用 Rust 编写的交互式命令行备忘单工具。它允许用户通过模糊搜索快速查找所需的命令，并可以直接执行或复制到剪贴板。与传统的静态备忘单或 man 页面不同，navi 强调交互性和可定制性，旨在提升命令行操作的效率和体验。

主要特性

• 交互式浏览与搜索: navi 的核心优势在于其交互式界面。它通常与强大的模糊查找器 fzf 集成（尽管也可以配置使用其他查找器），让用户可以通过输入关键词快速筛选和定位命令。
• 备忘单支持: navi 使用 .cheat 文件作为备忘单来源。这些文件通常采用易于读写的 YAML 或 TOML 格式。用户可以从社区维护的备忘单仓库导入，也可以创建自己的备忘单。
• 参数化命令: 备忘单中的命令可以包含占位符（例如 <filename>）。当选择这样的命令时，navi 会提示用户输入具体的值，使得备忘单更加灵活和通用。
• 直接执行或编辑: 找到所需命令后，用户可以选择直接在终端中执行，或者将其插入到当前命令行进行编辑。
• 可定制性: 用户可以通过配置文件 (navi.toml) 定制 navi 的行为，例如更改模糊搜索工具、快捷键、备忘单搜索路径等。
• 社区驱动: navi 拥有一个活跃的社区，贡献了涵盖各种工具（如 Git, Docker, Kubernetes, AWS CLI 等）的大量备忘单。

安装与快速入门

navi 提供了多种安装方式：

• 包管理器 (推荐):
  • macOS (Homebrew): brew install navi
  • Debian/Ubuntu (apt): 可能需要添加 PPA 或从 .deb 文件安装 (请查阅官方文档获取最新信息)
  • Fedora (dnf): dnf install navi
  • Arch Linux: pacman -S navi
• Cargo (适用于 Rust 开发者): cargo install navi
• 预编译二进制文件: 从 GitHub Releases 页面下载适合你操作系统的二进制文件。

快速入门:

1. 启动 navi: 在终端中输入 navi 并回车。
2. 搜索: 输入关键词进行模糊搜索，例如 git commit。
3. 选择: 使用上下箭头选择你需要的命令。
4. 执行/编辑:
   • 按 Enter 键执行选中的命令（如果命令包含占位符，会提示输入）。
   • 按 Ctrl+Y (或其他配置的快捷键) 将命令复制到剪贴板。
   • 按 Ctrl+G (或其他配置的快捷键) 将命令插入到当前命令行光标位置。

配置文件: navi 的配置文件通常位于 ~/.config/navi/config.toml (或 $XDG_CONFIG_HOME/navi/config.toml)。你可以通过编辑此文件来自定义 navi 的行为。

使用场景/案例

• 查找复杂命令: 快速找到 git, docker, kubectl, ffmpeg, openssl 等工具的不常用但功能强大的命令。例如，搜索 “docker list stopped containers” 或 “git rebase interactive”。
• 团队共享命令: 团队可以维护一套共享的 .cheat 文件，包含项目特定的脚本、部署命令或内部工具的最佳实践，并通过版本控制系统（如 Git）进行管理和分发。
• 学习新工具: 通过浏览社区提供的备忘单，快速了解一个新命令行工具的常用命令和用法。
• 自动化辅助: 虽然 navi 主要用于交互式场景，但其命令查找能力也可以被脚本间接利用。

自定义与扩展

navi 的强大之处在于其可扩展性：

• 创建自己的备忘单:
  1. 创建一个 .cheat 文件 (例如 my_commands.cheat)。

  2. 使用 YAML 或 TOML 格式编写备忘单。基本结构如下 (YAML 示例):
     “`yaml
     % My Custom Commands, custom tag

     List files sorted by modification time

     ls -lt

     Find files by name (case-insensitive)

     find . -iname ‘‘
     3. 在命令中使用 `<placeholder>` 定义变量。
* **管理备忘单路径:** 通过设置 `NAVI_PATH` 环境变量，告知 `navi` 在哪些目录中搜索 `.cheat` 文件。你可以将自己的备忘单目录添加到此路径中。bash
     export NAVI_PATH=”/path/to/my/cheats:/path/to/community/cheats”
     ``
* **导入社区备忘单:**navi` 可以方便地从在线仓库导入备忘单。查阅官方文档了解如何添加和更新社区备忘单。

与类似工具对比

navi 结合了 fzf 的强大交互性和备忘单管理能力，提供了比 tldr 和 cheat 更动态的体验，但学习曲线和配置可能稍复杂。fzf 本身是一个更通用的工具，navi 利用它来专注于备忘单场景。

性能与考量

• 性能: navi 使用 Rust 编写，通常具有良好的性能和较低的资源消耗。然而，根据社区反馈，当加载非常庞大（成千上万条目）的备忘单库时，启动和初次搜索可能会有轻微延迟。
• 兼容性: 一些用户报告在特定的终端配置或 Shell (如 Zsh + Oh-My-Zsh) 下可能遇到集成问题。建议查阅 GitHub Issues 或社区讨论寻求解决方案。
• 备忘单质量: 搜索结果的准确性依赖于 .cheat 文件的质量和结构。

总结

navi 是一个非常实用的命令行效率工具，特别适合那些需要频繁与复杂命令行工具打交道但又不想记忆所有细节的用户。其交互式的模糊搜索、参数化命令以及强大的自定义能力，使其成为传统静态备忘单和 man 页面的有力补充。通过利用社区资源和创建个人备忘单，navi 可以显著提升你的命令行工作效率。

如果你厌倦了反复搜索命令或查阅冗长的文档，不妨尝试一下 navi，体验更流畅的命令行交互。访问 GitHub 仓库 了解更多信息、参与社区或贡献代码。