Linux环境下使用Neovim(Lua)实现模板变量填充及批量替换

现有模板内容：

[user]
    name = ${NAME}
    email = ${EMAIL}

其中${NAME}和${EMAIL}为变量占位符，已定义变量值：

NAME=Carson
EMAIL=test@xxx.com

需要将变量值填充至模板，得到目标输出：

[user]
    name = Carson
    email = test@xxx.com

请问在Linux系统下，能否通过Neovim（支持Lua脚本）实现该需求？

可行方案 #

当然可以实现，这里提供几种实用的Lua脚本实现方式：

方式1：直接操作当前缓冲区替换 #

通过Lua调用Neovim内置的替换命令，对当前打开的模板文件内容进行替换：

-- 定义变量映射表
local vars = {
    NAME = "Carson",
    EMAIL = "test@xxx.com"
}

-- 遍历变量执行全局替换
for var_name, var_value in pairs(vars) do
    -- 转义特殊字符避免替换出错
    local escaped_pattern = vim.fn.escape("${" .. var_name .. "}", "\\/")
    local escaped_value = vim.fn.escape(var_value, "\\/")
    vim.cmd(string.format("%%s/%s/%s/g", escaped_pattern, escaped_value))
end

将这段代码保存为Lua脚本，在Neovim中打开模板文件后执行:luafile your_script.lua即可完成替换。

方式2：批量处理文件（无需打开缓冲区） #

如果需要批量处理模板文件，可通过Lua的文件API读取、替换、写入内容：

local vars = {
    NAME = "Carson",
    EMAIL = "test@xxx.com"
}

-- 读取模板文件
local template_path = "/path/to/your/template.ini"
local input_file = io.open(template_path, "r")
local content = input_file:read("*a")
input_file:close()

-- 替换所有变量占位符
for var_name, var_value in pairs(vars) do
    content = content:gsub("${" .. var_name .. "}", var_value)
end

-- 写入目标文件
local output_path = "/path/to/your/output.ini"
local output_file = io.open(output_path, "w")
output_file:write(content)
output_file:close()

直接在Neovim中执行该脚本，或者通过nvim --headless -c 'luafile your_script.lua' -c quit命令在无界面模式下运行。

方式3：读取系统环境变量替换 #

如果变量已通过export NAME=Carson等方式在系统环境中定义，可直接读取环境变量进行替换：

-- 从环境变量获取变量值
local vars = {
    NAME = os.getenv("NAME"),
    EMAIL = os.getenv("EMAIL")
}

-- 仅替换已存在的变量
for var_name, var_value in pairs(vars) do
    if var_value then
        local escaped_pattern = vim.fn.escape("${" .. var_name .. "}", "\\/")
        local escaped_value = vim.fn.escape(var_value, "\\/")
        vim.cmd(string.format("%%s/%s/%s/g", escaped_pattern, escaped_value))
    end
end

这种方式无需在脚本中硬编码变量值，适配灵活。

内容的提问来源于stack exchange，提问作者Carson