tsconfig 中 noUnusedLocals 如何配置
常见问答
在 tsconfig 里开启 noUnusedLocals 后，代码会受到什么影响？
我想知道把 noUnusedLocals 打开后，TypeScript 会检查哪些内容，平时写代码时会带来哪些变化？
noUnusedLocals 的作用范围
noUnusedLocals 用来检查未使用的局部变量、函数参数导入项等声明。开启后，编译器会对这些“声明了但没有被用到”的内容给出报错，帮助你及时清理冗余代码，减少无效依赖，也能让代码更整洁。
如果项目里已经有很多历史代码，适合直接启用 noUnusedLocals 吗？
老项目里可能存在不少未使用的变量和导入，直接打开这个选项会不会影响构建，我该怎么评估？
在老项目中启用的建议
如果历史代码较多，直接开启 noUnusedLocals 可能会产生大量编译错误，影响现有流程。更稳妥的方式是先在局部模块试用，清理核心代码后再逐步推广到全项目。这样可以降低一次性改动带来的风险。
noUnusedLocals 和 noUnusedParameters 有什么区别，应该一起配置吗？
我看到这两个选项都和“未使用”有关，它们分别检查什么场景，实际项目里有没有必要同时打开？
两个选项的检查重点
noUnusedLocals 主要检查局部变量、导入、函数内部声明等未使用内容；noUnusedParameters 主要检查函数参数是否被使用。很多项目会把它们一起开启，这样可以同时减少无效变量和无效参数，让类型检查更完整。
开启 noUnusedLocals 之后，某些导入只是为了类型声明也会报错吗？
我有些 import 看起来没在运行时代码里用到，但它们可能用于类型或副作用，TypeScript 会不会误判？
导入是否报错取决于实际使用方式
如果一个导入确实没有被使用，noUnusedLocals 通常会提示错误。对于仅用于类型的导入，可以使用 type-only import 方式来表达用途，避免被当成无效引用。若是为了模块副作用而导入，也需要确保写法符合项目配置和实际执行逻辑。
* 文章含AI生成内容