TypeScript 项目开启 strict 模式后 Tree Shaking 失效了？

程序猿奕瑞提问于 2026-03-05 12:12:18 阅读 58

优化

我用 Vite + TypeScript 搭了个项目，之前 Tree Shaking 正常，但一开 strict: true 就发现打包体积变大了，没用的代码没被删掉。是不是 tsconfig 的配置影响了摇树？

我试过检查导出方式，也确认用了 ES Module 语法，但就是不行。这是我的 tsconfig 配置：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "moduleResolution": "bundler"
  }
}

我来解答赞 19 收藏

反馈

2 条解答

小东焕 Lv1

遇到过类似问题，这其实是 strict 模式和类型推断导致的副作用。官方文档里说 strict 模式会开启 noImplicitAny 等一堆严格检查，这会影响类型推导方式。

关键问题在于：当你的代码有潜在类型问题时，TS 会生成更详细的结构信息，导致打包工具认为这些代码被依赖了。解决方法：

1. 检查项目中是否有隐式 any 的类型警告，特别是第三方库的类型定义
2. 可以尝试在 tsconfig 里单独开启 strict 的子选项而不是直接 "strict": true，比如：

{

  "compilerOptions": {

    "strictNullChecks": true,

    "strictFunctionTypes": true,

    // 其他你需要的严格选项

  }

}

3. 确保你的 Vite 配置中 optimizeDeps.exclude 没误伤需要的依赖

我之前有个项目就是因为一个鬼畜的 any 类型导致整个工具类被保留下来了，排查了半天。建议先用 npx vite-bundle-visualizer 看看具体是哪些模块没被 tree shaken 掉。

2026-03-10 08:05

UX子璇 Lv1

我遇到过类似问题，strict模式确实会影响Tree Shaking，特别是strictNullChecks这个子选项。你现在的配置是把所有strict相关检查都打开了，建议先单独调试看看。

试试这样改tsconfig.json：

{

  "compilerOptions": {

    "target": "ES2020",

    "module": "ESNext",

    "strict": false,

    "strictNullChecks": false,

    "esModuleInterop": true,

    "skipLibCheck": true,

    "moduleResolution": "bundler"

  }

}

然后逐步开启其他严格检查，比如先开noImplicitAny看看影响。通常问题出在类型声明被误认为有副作用，导致打包工具不敢删代码。

另外检查下你的类型定义文件，别用export =这种老语法，用标准的ES Module导出。顺便提醒，开strict模式虽然安全但确实可能带来打包问题，生产环境记得做最终的包体积检查。

如果还不行，在vite.config.js里显式配置treeshake试试：

export default defineConfig({

  build: {

    minify: 'terser',

    terserOptions: {

      compress: {

        pure_funcs: ['console.log']

      }

    }

  }

})

2026-03-05 12:24