Neovim设置所有分栏透明背景异常：仅NeoTree分栏生效

核心配置：覆盖关键高亮组 #

仅设置Normal高亮组不足以覆盖所有场景，需要补充非活动窗口、浮动窗口等相关组的透明设置，在init.lua中添加以下代码：

-- 基础窗口透明
vim.api.nvim_set_hl(0, "Normal", { bg = "none", ctermbg = "none" })
vim.api.nvim_set_hl(0, "NormalNC", { bg = "none", ctermbg = "none" }) -- 非活动窗口
vim.api.nvim_set_hl(0, "NormalFloat", { bg = "none", ctermbg = "none" }) -- 浮动窗口
vim.api.nvim_set_hl(0, "WinSeparator", { bg = "none", fg = "#555555" }) -- 窗口分隔线，可自定义颜色

-- 确保NeoTree分栏透明（按需保留）
vim.api.nvim_set_hl(0, "NeoTreeNormal", { bg = "none", ctermbg = "none" })
vim.api.nvim_set_hl(0, "NeoTreeNormalNC", { bg = "none", ctermbg = "none" })

防止主题/插件覆盖设置 #

多数颜色主题会在启动阶段重置高亮配置，需要通过自动命令在主题加载后重新应用透明规则：

vim.api.nvim_create_autocmd("ColorScheme", {
  callback = function()
    vim.api.nvim_set_hl(0, "Normal", { bg = "none", ctermbg = "none" })
    vim.api.nvim_set_hl(0, "NormalNC", { bg = "none", ctermbg = "none" })
    vim.api.nvim_set_hl(0, "NormalFloat", { bg = "none", ctermbg = "none" })
    vim.api.nvim_set_hl(0, "WinSeparator", { bg = "none", fg = "#555555" })
    vim.api.nvim_set_hl(0, "NeoTreeNormal", { bg = "none", ctermbg = "none" })
    vim.api.nvim_set_hl(0, "NeoTreeNormalNC", { bg = "none", ctermbg = "none" })
  end,
})

常见问题排查 #

• 若之前的自动脚本报错，多是语法问题：Lua配置中需用bg替代Vimscript的guibg，且必须通过vim.api.nvim_set_hl调用接口。
• 特殊窗口需单独配置：比如终端窗口需添加vim.api.nvim_set_hl(0, "Terminal", { bg = "none" })。
• 确认终端本身已开启透明背景（如Alacritty、Kitty等终端的配置中开启透明选项），否则Neovim的透明设置无法生效。

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