如何用Lua判断NeoVim启动时是否指定了待打开的文件

核心判定方法 #

直接调用Neovim内置的vim.fn.argc()接口即可，不需要自行解析命令行参数。该函数会返回启动时传入的非选项类位置参数（也就是待打开的文件路径参数）的总数：

• 执行无参数命令nvim启动时，返回值为0
• 执行nvim file.txt这类带文件路径的启动命令时，返回值大于0

稳妥实现代码 #

注意不要在插件初始化的最顶层直接做判断，避免时序问题导致计数不准，推荐绑定到VimEnter自动命令上执行，确保所有启动参数加载完成后再判定：

vim.api.nvim_create_autocmd("VimEnter", {
  callback = function()
    -- 仅当存在启动传入的文件参数时执行目标逻辑
    if vim.fn.argc() > 0 then
      -- 此处替换为你需要执行的自定义逻辑
    end
  end,
  once = true, -- 确保逻辑只在启动阶段执行一次
})

可选：精准过滤非文件参数场景 #

如果需要排除传入参数不是本地可读文件的场景（比如传入-读取标准输入、传入不存在的路径等），可以加一层参数校验：

local function startup_has_file_args()
  local arg_count = vim.fn.argc()
  if arg_count == 0 then return false end
  -- 遍历所有启动参数，只要存在一个可读本地文件就判定为符合场景
  for idx = 0, arg_count - 1 do
    local current_arg = vim.fn.argv(idx)
    if current_arg ~= "-" and vim.fn.filereadable(current_arg) == 1 then
      return true
    end
  end
  return false
end

vim.api.nvim_create_autocmd("VimEnter", {
  callback = function()
    if startup_has_file_args() then
      -- 此处替换为你需要执行的自定义逻辑
    end
  end,
  once = true,
})

避坑提示 #

• 不要用#vim.v.argv做判断，这个数组包含了nvim命令本身、所有启动选项（比如--clean/-c等配置参数），无法准确区分是否传入了待打开的文件
• 不要在插件setup函数的最外层直接执行判断，部分懒加载、启动时序特殊的场景下会出现判定错误，绑定VimEnter事件是兼容性最好的方案

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