None-ls.nvim 中缓存函数参数重复追加问题的技术分析

在 Neovim 生态系统中，none-ls.nvim 是一个重要的插件，它提供了丰富的 LSP 功能支持。最近发现了一个关于参数处理的 bug，当使用缓存函数时，extra_args 会被重复追加，导致命令执行异常。

问题背景

在 none-ls.nvim 的 builtin 功能中，某些命令使用了缓存机制来优化性能。具体来说，是通过 require("null-ls.helpers").cache.by_bufnr 方法实现的。当这些命令配置了 extra_args 参数时，会出现参数被重复追加的问题。

问题现象

1. 首次执行命令时，extra_args 被正确添加
2. 后续执行时，extra_args 会被重复追加
3. 每次执行都会在命令参数中多出一个 extra_args 的副本

技术分析

通过调试日志和代码分析，发现问题出在参数处理逻辑上：

1. make_builtin 函数中调用了 handle_function_opt 来处理原始参数
2. handle_function_opt 对函数类型的参数直接返回原值而不做拷贝
3. 由于缓存函数返回的是可变表引用，后续的参数追加操作直接修改了缓存

解决方案

正确的处理方式应该是：

1. 无论参数是否为函数，都应该返回其副本
2. 避免直接修改缓存中的数据结构
3. 确保每次调用都能获得独立的参数列表

影响范围

这个问题主要影响：

1. 使用缓存机制的 builtin 命令
2. 配置了 extra_args 参数的场景
3. 需要多次执行的命令（如保存时触发的诊断）

最佳实践

开发者在使用 none-ls.nvim 时应注意：

1. 检查 builtin 命令是否使用了缓存机制
2. 谨慎使用 extra_args 参数
3. 关注命令执行日志，确保参数正确

总结

参数处理是插件开发中的重要环节，特别是在涉及缓存优化时，需要特别注意数据隔离问题。none-ls.nvim 的这个案例提醒我们，在性能优化和功能正确性之间需要找到平衡点。

对于普通用户来说，如果遇到命令参数异常增加的情况，可以考虑检查是否是类似机制导致的问题，并及时更新插件版本获取修复。