rustaceanvim

• debuggables打开一个提示框，让你选择可用的目标。

• debug在当前光标位置搜索目标。

:RustLsp[!] debuggables {args[]}?
:RustLsp[!] debug {args[]}?

vim.cmd.RustLsp('debug')
vim.cmd.RustLsp('debuggables')
-- 或者，运行上一个可调试项：
vim.cmd.RustLsp { 'debuggables', bang = true }
-- 或者，覆盖可执行文件的参数：
vim.cmd.RustLsp {'debuggables', 'arg1', 'arg2' }

使用感叹号!调用命令将重新运行最后一个可调试项。

需要：

• nvim-dap (请阅读该插件的文档)。
• 一个调试适配器（例如lldb-dap 或codelldb）。

默认情况下，当LSP客户端连接时，此插件会静默尝试自动加载nvim-dap 配置。加载后，你可以使用require('dap').continue()或:DapContinue调用它们。 可以通过设置vim.g.rustaceanvim.dap.autoload_configurations = false来禁用此功能。

• :RustLsp debuggables只会加载由rust-analyzer创建的调试配置。
• require('dap').continue()将加载所有Rust调试配置， 包括在.vscode/launch.json中指定的配置 （参见:h dap-launch.json）。
• 请注意，rustaceanvim可能只能在rust-analyzer完成初始化后 加载DAP配置（在大型项目中可能在客户端连接后）。这意味着 DAP配置可能不会在启动时立即加载。

• runnables打开一个提示框，让你选择可用的目标。
• run在当前光标位置搜索目标。

:RustLsp[!] runnables {args[]}?
:RustLsp[!] run {args[]}?

vim.cmd.RustLsp('run') 
vim.cmd.RustLsp('runnables')
-- 或者，运行上一个可运行项：
vim.cmd.RustLsp { 'runnables', bang = true }
-- 或者，覆盖可执行文件的参数：
vim.cmd.RustLsp {'runnables', 'arg1', 'arg2' }

使用感叹号!调用命令将重新运行最后一个可运行项。

如果你使用的是Neovim >= 0.10，你可以将vim.g.rustaceanvim.tools.test_executor 选项设置为'background'，这样插件将在后台运行测试， 解析结果，并尽可能将失败的测试显示为诊断信息。

在Neovim 0.9中也可以实现这一点，但测试不会在后台运行， 而是会阻塞UI。

:RustLsp[!] testables {args[]}?

vim.cmd.RustLsp('testables')
-- 或者，运行上一个可测试项：
vim.cmd.RustLsp { 'testables', bang = true }
-- 或者，覆盖可执行文件的参数：
vim.cmd.RustLsp {'testables', 'arg1', 'arg2' }

使用感叹号!调用命令将重新运行最后一个可测试项。

此插件提供了一个neotest适配器， 你可以按以下方式将其添加到neotest中：

require('neotest').setup {
    -- ...,
    adapters = {
      -- ...,
      require('rustaceanvim.neotest')
    },
}

注意：如果你使用rustaceanvim的neotest适配器， 请不要添加neotest-rust。

以下是rustaceanvim的适配器和neotest-rust的比较：

:RustLsp expandMacro

vim.cmd.RustLsp('expandMacro')

:RustLsp rebuildProcMacros

vim.cmd.RustLsp('rebuildProcMacros')

:RustLsp moveItem {up|down}

vim.cmd.RustLsp { 'moveItem',  'up' }
vim.cmd.RustLsp { 'moveItem',  'down' }

有时，rust-analyzer会按类别对代码操作进行分组， 这不被Neovim内置的vim.lsp.buf.codeAction支持。 此插件提供了一个带有UI的命令，可以执行：

:RustLsp codeAction

vim.cmd.RustLsp('codeAction')

如果您将选项vim.g.rustaceanvim.tools.code_actions.ui_select_fallback 设置为true（默认为false），当没有分组代码操作时， 它将回退到使用vim.ui.select。

注意：要激活悬停操作，需要运行命令两次。 这会将您移动到窗口中，然后按回车键选择您想要的选项。 或者，您可以在配置中将auto_focus设置为true， 这样您将自动进入悬停操作窗口。

:RustLsp hover actions

vim.cmd.RustLsp { 'hover', 'actions' }

默认情况下，此插件用悬停操作替换了Neovim的内置悬停处理程序， 因此您也可以使用vim.lsp.buf.hover()。

:RustLsp hover range

vim.cmd.RustLsp { 'hover', 'range' }

在错误诊断上显示一个悬停窗口，其中包含来自rust错误代码索引 的解释（如果诊断有错误代码）。

:RustLsp explainError {cycle?|current?}

vim.cmd.RustLsp('explainError') -- 默认为'cycle'
vim.cmd.RustLsp({ 'explainError', 'cycle' })
vim.cmd.RustLsp({ 'explainError', 'current' })

• 如果使用cycle或无参数调用： 类似于vim.diagnostic.goto_next， explainError将从光标位置开始循环诊断， 直到找到带有错误代码的诊断。

• 如果使用current调用： 仅在当前光标行搜索诊断。

显示一个悬停窗口，其中包含渲染的诊断，如cargo build期间显示的那样。 对于解决借用和泛型相关的bug很有用， 因为它将重要部分（有时跨文件）整合在一起。

:RustLsp renderDiagnostic {cycle?|current?}

vim.cmd.RustLsp('renderDiagnostic') -- 默认为'cycle'
vim.cmd.RustLsp({ 'renderDiagnostic', 'cycle' })
vim.cmd.RustLsp({ 'renderDiagnostic', 'current' })

• 如果使用cycle或无参数调用： 类似于vim.diagnostic.goto_next， renderDiagnostic将从光标位置开始循环诊断， 直到找到带有渲染数据的诊断。

• 如果使用current调用： 仅在当前光标行搜索诊断。

:RustLsp openCargo

vim.cmd.RustLsp('openCargo')

打开光标下符号的docs.rs文档。

:RustLsp openDocs

vim.cmd.RustLsp('openDocs')

:RustLsp parentModule

vim.cmd.RustLsp('parentModule')

rust-analyzer支持过滤工作区符号搜索。

:RustLsp[!] workspaceSymbol {onlyTypes?|allSymbols?} {query?}

vim.cmd.RustLsp('workspaceSymbol')
-- 或
vim.cmd.RustLsp { 
  'workspaceSymbol', 
  '<onlyTypes|allSymbols>' --[[ 可选 ]], 
  '<query>' --[[ 可选 ]], 
  bang = true --[[ 可选 ]]
}

• 使用感叹号 ! 调用命令将在搜索中包含依赖项。
• 您还可以通过设置 rust-analyzer 的 workspace.symbol.search 服务器选项来影响 vim.lsp.buf.workspace_symbol() 的行为。

将选定的行智能地合并成一行，自动修复空白、尾随逗号和括号。 在普通模式下适用于单行，在可视模式下适用于多行。

:RustLsp joinLines

vim.cmd.RustLsp('joinLines')

• 在普通模式下搜索整个缓冲区。
• 在可视模式下搜索选定区域。

:RustLsp ssr {query}

vim.cmd.RustLsp { 'ssr', '<query>' --[[ 可选 ]] }

:RustLsp crateGraph {backend {output}}

vim.cmd.RustLsp { 'crateGraph', '[backend]', '[output]' }

需要：

• graphviz 中的 dot

:RustLsp syntaxTree

vim.cmd.RustLsp('syntaxTree')

在后台线程中运行 cargo check 或其他兼容命令（如 clippy）， 并根据命令输出提供 LSP 诊断信息。

在大型项目中很有用，因为每次保存时运行 cargo check 可能会很耗时。

:RustLsp flyCheck {run?|clear?|cancel?}

vim.cmd.RustLsp('flyCheck') -- 默认为 'run'
vim.cmd.RustLsp { 'flyCheck', 'run' }
vim.cmd.RustLsp { 'flyCheck', 'clear' }
vim.cmd.RustLsp { 'flyCheck', 'cancel' }

[!注意]

这只有在设置选项 ['rust-analzyer'].checkOnSave = false 时才有用。

打开一个缓冲区，显示光标所在函数的 HIR 或 MIR 的文本表示。 对调试或处理 rust-analyzer 本身很有用。

:RustLsp view {hir|mir}

vim.cmd.RustLsp { 'view', 'hir' }
vim.cmd.RustLsp { 'view', 'mir' }

打开一个缓冲区，显示光标附近函数的 MIR 或其他内容的文本表示。 实现类似 Rust Playground 的体验。

注意：目前需要 Rust 的 tree-sitter 解析器和 nightly 编译器工具链。

:Rustc unpretty {hir|mir|...}

vim.cmd.Rustc { 'unpretty', 'hir' }
vim.cmd.Rustc { 'unpretty', 'mir' }
-- ...

需要：

• Rust 的 tree-sitter 解析器（:Rustc unpretty 命令需要）。 可以使用 nvim-treesitter 安装。