如何在telescope.nvim中配置特定隐藏文件/文件夹（如.gitlab-ci）纳入搜索结果，同时保留默认忽略规则？

阿华AIGC实验室

2026-4-28

解决方案：让Telescope仅例外检索.gitlab-ci文件/文件夹

我刚好也遇到过类似的需求——既要保持Telescope默认忽略隐藏文件和.gitignore内容的行为，又要让特定的.gitlab-ci相关文件/文件夹能被搜到。下面是针对你用到的三个Telescope功能（find_files、live_grep、file_browser）的具体配置方案：

1. 配置`find_files`（文件查找）

find_files默认用ripgrep或fd作为搜索后端，我们可以通过传递额外参数，在保持默认忽略规则的同时，强制包含.gitlab-ci相关内容：

require('telescope').setup({
  pickers = {
    find_files = {
      additional_args = function()
        return {
          "--glob", "!.git",          -- 继续忽略.git文件夹
          "--glob", "!.gitignore",   -- 继续忽略.gitignore文件
          "--glob", "!.gitlab-ci*",  -- 关键：不忽略匹配.gitlab-ci开头的所有文件/文件夹
          -- 如果你的.gitlab-ci是单独的文件夹，用"!.gitlab-ci/**"更精准
        }
      end,
      respect_gitignore = true,  -- 保持默认：遵守.gitignore规则
      hidden = false,            -- 保持默认：不显示其他隐藏文件
    },
  },
})

如果你用的是fd作为后端，参数格式稍有不同，替换成下面的additional_args即可：

additional_args = function()
  return {
    "--exclude", ".git",
    "--exclude", ".gitignore",
    "--include", ".gitlab-ci*",
  }
end

2. 配置`live_grep`（内容搜索）

live_grep是用来搜索文件内容的，同样需要添加参数让它能检索.gitlab-ci文件里的内容：

require('telescope').setup({
  pickers = {
    live_grep = {
      additional_args = function()
        return {
          "--glob", "!.git",
          "--glob", "!.gitignore",
          "--glob", "!.gitlab-ci*",  -- 允许搜索.gitlab-ci相关文件的内容
          "--hidden",                -- 配合glob，确保能搜到隐藏的.gitlab-ci文件
        }
      end,
      respect_gitignore = true,
    },
  },
})

3. 配置`file_browser`（文件浏览器）

file_browser的配置逻辑稍不同，我们可以先开启显示隐藏文件，再通过ignore_patterns排除掉除.gitlab-ci之外的其他隐藏内容：

require('telescope').setup({
  extensions = {
    file_browser = {
      hidden = true,  -- 先开启显示隐藏文件
      respect_gitignore = true,  -- 遵守.gitignore规则
      -- 忽略：.git文件夹、.gitignore文件，以及所有以.开头但不是.gitlab-ci的内容
      ignore_patterns = { "^%.git$", "^%.gitignore$", "^%.[^g].*$" },
    },
  },
})