sad.nvim 使用教程

1、项目介绍

sad.nvim 是一个基于 Neovim 的强大项目范围内的查找和替换工具。它利用了 ms-jpq/sad 库的威力，结合了交互式选择功能，让您的代码编辑体验提升到新的层次。通过与 fzf 集成，您可以方便地确认并应用更改，同时还支持 fd 和 git ls_files 来搜索文件。此外，sad.nvim 还能与 delta 一起使用，提供漂亮的差异显示。

2、项目快速启动

安装

首先，确保您已经安装了 Neovim 和 Plug 插件管理器。然后在您的 Neovim 配置文件（通常是 ~/.config/nvim/init.vim）中添加以下内容：

call plug#begin('~/.config/nvim/plugged')
Plug 'ray-x/sad.nvim'
call plug#end()

保存并退出，然后在 Neovim 中运行 :PlugInstall 来安装插件。

基本使用

1. 打开 Neovim 并进入您的项目目录。
2. 使用以下命令启动 sad.nvim：

:Sad <search_pattern> <replace_pattern>

例如，将所有 foo 替换为 bar：

:Sad foo bar

3. 使用 <Tab> 切换选择，<CR> 确认，<Esc> 取消。

3、应用案例和最佳实践

项目级别的替换

在大型项目中，您可以在所有相关文件中批量替换特定单词或模式，无需逐个文件手动操作。例如，将所有 TODO 替换为 FIXME：

:Sad TODO FIXME

精确匹配与过滤

通过设置 exact 参数，您可以实现精确匹配，并通过指定文件扩展名来限制搜索范围。例如，仅在 Lua 文件中进行替换：

:Sad --exact --file-filter *.lua TODO FIXME

实时预览与确认

fzf 提供的实时预览功能使您可以查看每个更改的影响，确保在应用之前是正确的。

4、典型生态项目

fzf.vim

fzf.vim 是一个强大的模糊查找工具，与 sad.nvim 集成，提供交互式的匹配项选择功能。

delta

delta 是一个用于以更美观的形式展示变更前后的差异的工具，与 sad.nvim 一起使用，提高阅读体验。

nvim-lspconfig

nvim-lspconfig 是 Neovim 的 LSP 配置插件，与 sad.nvim 结合使用，提供更强大的代码编辑和替换功能。

通过以上教程，您应该能够快速上手并充分利用 sad.nvim 的功能，提升您的代码编辑效率。