RustaceanVim 中自动移除未使用导入功能的实现探讨

在 Rust 开发中，保持代码整洁是提高可维护性的重要环节。未使用的导入语句不仅会增加代码量，还可能影响代码的可读性。本文将探讨如何在 RustaceanVim 中实现自动移除未使用导入的功能。

当前功能现状

RustaceanVim 目前通过 LSP 集成已经支持基本的未使用导入移除功能。用户可以通过调用 :RustLsp codeAction 或 vim.lsp.buf.code_action() 来触发代码操作菜单，其中包含以下选项：

1. "Remove the unused import" - 移除当前行的单个未使用导入
2. "Remove the whole use item" - 移除整个 use 语句
3. "Remove all the unused imports" - 移除当前文件中的所有未使用导入

功能局限性

虽然提供了"Remove all the unused imports"选项，但实际测试表明该功能目前仅能移除当前光标所在行的未使用导入，而非整个文件范围内的所有未使用导入。这与许多开发者期望的行为存在差异。

技术实现方案

对于希望实现自动移除所有未使用导入的开发者，可以考虑以下 Lua 脚本方案。该脚本通过创建自动命令，在文件保存时自动触发未使用导入的移除操作：

vim.api.nvim_create_autocmd("BufWritePost", {
    pattern = "*.rs",
    callback = function()
        local params = vim.lsp.util.make_range_params()
        params.context = {
            only = { "quickfix" },
            diagnostics = vim.tbl_map(function(d)
                return d.user_data.lsp
            end, vim.diagnostic.get(0)),
            triggerKind = 1,
        }
        params.range = {
            start = { line = 0, character = 0 },
            ["end"] = { line = #vim.api.nvim_buf_get_lines(0, 0, -1, false), character = 0 },
        }
        vim.lsp.buf_request(0, "textDocument/codeAction", params, function(err, result, context, config)
            for _, action in ipairs(result or {}) do
                if action.title == "Remove all the unused imports" then
                    local client = vim.lsp.get_client_by_id(context.client_id)
                    client.request("codeAction/resolve", action, function(err_resolve, resolved_action)
                        if err_resolve then
                            vim.notify(err_resolve.code .. ": " .. err_resolve.message, vim.log.levels.ERROR)
                            return
                        end
                        if resolved_action.edit then
                            vim.lsp.util.apply_workspace_edit(resolved_action.edit, client.offset_encoding)
                        end
                    end)
                    return
                end
            end
        end)
    end,
})

未来改进方向

完整的文件范围导入整理功能目前尚未在 rust-analyzer 中实现，但已被列入功能请求列表。开发者可以期待未来版本中可能会加入以下增强功能：

1. 真正全局范围的未使用导入移除
2. 导入语句的自动排序和组织
3. 可配置的导入分组规则

总结

虽然当前 RustaceanVim 的未使用导入移除功能存在一定局限性，但通过自定义脚本已经可以实现基本的自动化处理。随着 rust-analyzer 的持续发展，这一功能的完善值得期待。开发者可以根据项目需求选择适合的解决方案，保持 Rust 代码的整洁和高效。