Var 和 Vim 有什么区别？传统 Vimscript 变量与现代 Neovim Api

从本质上讲，“VAR”和“vim”之间的区别在于一个遗留的数据存储系统和一个现代的、全面的编程接口。 “VAR”指的是传统的 Vimscript 变量（如 g:my_var），它是一个简单的键值存储。相比之下，vim 是 Neovim 中的全局 Lua 对象，它提供了一个结构化、强大且完整的 API，用于与编辑器的各个方面进行交互。

简而言之，Vimscript 变量就像你贴在编辑器某个地方的一张简单的便利贴。而 vim 对象则是整个控制面板，通过一个清晰现代的接口，让你能够访问编辑器的引擎、设置和功能。

理解“VAR”：Vimscript 变量系统

“VAR”这个术语并非正式的关键字，而是代表了 Vim 中使用 Vimscript 变量存储状态的传统方法。该系统通过使用特殊前缀来表示作用域。

作用域前缀的作用

Vimscript 变量总是以一个定义其生命周期和可见性的前缀开头。理解这些是理解旧系统的关键。

g: (全局): 随处可访问，跨所有标签页、窗口和缓冲区。这是用户配置和插件设置最常用的。
b: (缓冲区): 绑定到特定的缓冲区（加载到内存中的文件）。用于存储缓冲区本地信息，例如特定文件的编译器标志。
w: (窗口): 绑定到特定的窗口（缓冲区的视图）。
t: (标签页): 绑定到特定的标签页。
v: (Vim 内部): 保留给 Vim 自身定义的变量，例如 v:count。

核心概念：直接状态修改

使用这些变量涉及直接在特定作用域中设置或获取值。在 Vimscript 中，你使用 let g:my_var = 'value'。在 Neovim 的 Lua 中，你会使用 vim.g.my_var = 'value'。在这两种情况下，你都在直接操作一个全局的键值字典。

理解“vim”：Neovim Lua API

当开发者提到 vim 时，他们指的是从 Lua 环境（init.lua 或 Lua 插件）与 Neovim 进行所有交互的主要入口点。它是一个全局 Lua 表，充当结构化且文档完善的命名空间。

一个程序化和结构化的接口

与 Vimscript 变量分散的特性不同，vim 对象将对编辑器内部的访问组织成逻辑子模块。这使得代码更容易编写、阅读和调试。

关键 API 子模块

vim 对象包含许多模块，但有几个对于替代传统的 Vimscript 模式至关重要：

vim.g 和 vim.b: 这些是 Lua 表，作为访问全局 (g:) 和缓冲区局部 (b:) Vimscript 变量的桥梁。设置 vim.g.my_var 与设置 g:my_var 相同。
vim.o: 一种直接、结构化的方式来获取和设置编辑器选项（例如，vim.o.tabstop = 4），这远优于旧的 set tabstop=4 命令。
vim.fn: 一个调用任何内置 Vimscript 函数的桥梁（例如，vim.fn.expand('%') 获取当前文件路径）。
vim.api: Neovim 的核心。它提供了一套稳定、快速且功能丰富的函数，用于以编程方式操作缓冲区、窗口和编辑器状态。

理解权衡：遗留与现代

选择这两种方法中的哪一种完全取决于你的目标，特别是你优先考虑与旧版 Vim 的兼容性，还是现代 Neovim 生态系统的强大功能和清晰度。

Vimscript 变量的理由

使用 g:var 风格的主要原因是可移植性。如果你正在编写一个必须在标准 Vim 和 Neovim 上都能运行的插件或配置片段，你必须使用 Vimscript。它是共同的基准。

`vim` Lua API 的理由

对于任何仅针对 Neovim 的工作，vim API 都具有显著的优越性。它提供了结构和可发现性（你的语言服务器可以为 vim.api.* 提供自动补全），通过 LuaJIT 显著提高了性能，并通过定义良好的 API 而不是直接状态修改提高了安全性。

`vim.g` 桥梁：两全其美

vim.g 表是关键的连接。在 Lua 中编写 Neovim 插件时，你使用 vim.g 来定义配置变量。这允许你的用户通过传统的 Vimscript（let g:my_plugin_setting = 1）在他们的 init.vim 中或通过 Lua（vim.g.my_plugin_setting = 1）在他们的 init.lua 中配置你的插件。

为你的目标做出正确的选择

你的决定应该由你的具体情况来指导——无论你是编写个人配置、公共插件还是跨兼容脚本。

如果你的主要重点是个人 Neovim 配置 (init.lua): 默认使用 vim Lua API 处理所有内容 (vim.o, vim.keymap.set, vim.api)。它更快、更简洁、更易于维护。
如果你的主要重点是编写现代 Neovim 插件: 使用 vim.api 和其他 Lua 模块构建你的内部逻辑。通过 vim.g 暴露面向用户的设置，以提供稳定的配置接口。
如果你的主要重点是与经典 Vim 的兼容性: 你别无选择，只能使用传统的 Vimscript 变量系统 (g:, b: 等) 和 Vimscript 函数。

通过理解这种区别，你可以编写更有效、更易于维护且性能更好的编辑器配置和插件。

总结表：

特性	Vimscript 变量 (VAR)	Neovim Lua API (vim)
目的	遗留状态存储	现代、结构化的编辑器控制 API
语法	作用域前缀 (g:, b: 等)	组织化的模块 (vim.api, vim.o 等)
性能	较慢，解释型 Vimscript	更快，通过 LuaJIT 编译
可移植性	在 Vim 和 Neovim 中均可工作	仅限 Neovim
用例	跨编辑器兼容性	现代 Neovim 配置和插件