如何正确配置nvim-lspconfig、ESLint与TypeScript路径别名？

问题核心定位 #

你的问题本质是Neovim的ESLint插件错误加载了子目录的.eslintrc.js，而非项目根目录的主配置文件，导致：

1. 别名解析规则未生效，ESLint无法识别@company/*这类路径映射
2. 项目范围的导出使用检查失效，误报“Exported declaration not used within other modules”

直接运行ESLint命令行正常，也佐证了是Neovim插件的配置逻辑问题，而非ESLint本身的规则配置错误。

具体解决方案 #

1. 强制ESLint插件加载根目录配置 #

修改Neovim中nvim-lspconfig的ESLint服务配置，指定root_dir逻辑，确保插件优先识别项目根的配置文件：

require('lspconfig').eslint.setup({
  -- 强制从项目根目录加载配置，优先级：根.eslintrc.json > .eslintrc.js > package.json
  root_dir = function(fname)
    return require('lspconfig.util').root_pattern('.eslintrc.json', '.eslintrc.js', 'package.json')(fname)
  end,
  -- 保留其他原有配置
  on_attach = function(client, bufnr)
    -- 你的on_attach逻辑...
  end
})

如果使用null-ls或nvim-lint这类Lint插件，同样需要在插件配置中指定ESLint的cwd为项目根目录。

2. 修正eslint-import-resolver-typescript的项目路径 #

原配置中的project路径可能未覆盖根目录的tsconfig.json（你的@company别名是在根配置中定义的），需要调整为包含根配置的路径：

// 根目录.eslintrc.json
"settings": {
  "import/resolver": {
    "typescript": {
      // 同时包含根目录和子包的tsconfig，适配monorepo结构
      "project": ["./tsconfig.json", "packages/*/tsconfig.json"]
    }
  }
}

3. 确保ESLint规则适配TypeScript别名 #

在ESLint配置中明确规则参数，让import/no-unused-modules和@typescript-eslint/no-unused-vars能正确识别跨模块的别名导入：

"rules": {
  "import/no-unused-modules": ["warn", {
    "unusedExports": true,
    "ignoreExports": []
  }],
  "@typescript-eslint/no-unused-vars": ["warn", {
    "argsIgnorePattern": "^_",
    "varsIgnorePattern": "^_",
    "caughtErrorsIgnorePattern": "^_"
  }]
}

验证步骤 #

1. 重启Neovim，打开之前报错的文件
2. 触发ESLint检查（比如执行:EslintFixAll）
3. 确认“导出未使用”的误报警告消失

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