无法在tsconfig中排除文件夹致vite项目构建失败求助

核心问题分析 #

TypeScript的exclude选项不会排除被项目中其他文件引用的模块——只要代码里有import '@/lib/api/xxx'这类引用，该目录的文件还是会被TypeScript检查。另外你可能混淆了TypeScript编译器选项和ESLint规则导致的警告，这也是配置无效的常见原因。

具体解决方案 #

情况1：项目不需要引用该目录的代码 #

如果只是想彻底让Vite和TypeScript忽略这个目录：

1. 在vite.config.ts中配置Rollup排除该目录的打包处理：

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  build: {
    rollupOptions: {
      plugins: [
        require('@rollup/plugin-ignore')(['@/lib/api/**'])
      ]
    }
  },
  optimizeDeps: {
    exclude: ['@/lib/api/**']
  }
})

2. 在tsconfig.app.json中明确指定include范围，缩小TypeScript扫描范围：

{
  "include": ["src/**/*", "!src/lib/api/**"],
  // 原有其他配置保持不变
}

情况2：项目需要引用该目录的代码，仅忽略未使用变量警告 #

如果必须使用该目录的代码，只是想屏蔽未使用变量的报错：

1. 针对TypeScript：在src/lib/api目录下新建独立的tsconfig.json，单独关闭该目录的未使用变量检查：

{
  "compilerOptions": {
    "noUnusedLocals": false,
    "noUnusedParameters": false
  }
}

2. 针对ESLint：在项目根目录的ESLint配置文件（.eslintrc.cjs/.eslintrc.json）中添加忽略规则：

{
  "ignorePatterns": ["src/lib/api/**"]
}

如果不想完全忽略ESLint，仅关闭特定规则，可以用配置覆盖：

{
  "overrides": [
    {
      "files": ["src/lib/api/**/*.ts", "src/lib/api/**/*.tsx"],
      "rules": {
        "@typescript-eslint/no-unused-vars": "off",
        "no-unused-vars": "off"
      }
    }
  ]
}

额外检查点 #

• 确认npm run build命令是否附带了lint检查（比如脚本里包含npm run lint），如果有，需要确保lint命令也遵守上述忽略规则。
• 检查是否有其他工具（如Prettier）在扫描该目录，如有需要添加对应忽略配置。

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