文档教程【免费下载链接】TypeScriptTypeScript 使用手册中文版翻译。http://www.typescriptlang.org项目地址https://gitcode.com/gh_mirrors/typ/TypeScript点击查看免费下载本文聚焦 TypeScript 2.6 版本引入的两项破坏性改动--noUnusedLocals/--noUnusedParameters对只写不读声明的全新检测逻辑以及环境模块ambient module声明文件中禁止任意表达式作为导出值的新规则。阅读本文后你将理解这两项改动的触发条件、报错信息、正确的迁移写法以及在升级到 TypeScript 2.6 及以上版本时如何快速定位和修复受影响的代码。只写引用Write-only现在会被标记为未使用TypeScript 2.6 修复了--noUnusedLocals和--noUnusedParameters两个编译选项的实现逻辑。在此之前这两个选项只检查声明是否被引用reference从 2.6 开始它们检查的是声明的值是否被读取read。任何只被写入、却从未被读取的声明现在都会被标记为未使用。选项的语义与默认值在本仓库的编译选项文档中这两个选项的定义如下选项类型默认值描述--noUnusedLocalsbooleanfalse若有未使用的局部变量则抛错。--noUnusedParametersbooleanfalse若有未使用的参数则抛错。两个选项默认均为关闭状态可以在命令行或tsconfig.json中显式开启。触发条件只写不读的代码下面这段代码在 TypeScript 2.5 及更早版本中不会产生编译错误但在启用--noUnusedLocals和--noUnusedParameters的 TypeScript 2.6 中会被标记为未使用function f(n: number) { n 0; } class C { private m: number; constructor() { this.m 0; } }分析这段代码函数f的参数n只被赋值n 0其值从未在任何地方被读取因此触发--noUnusedParameters报错类C的私有属性m同样只被写入this.m 0从未被读取因此触发--noUnusedLocals报错。注意在 TypeScript 2.6 中类私有属性的未使用检查归入--noUnusedLocals的管辖范围因为对于该检查器而言它们属于局部的声明。这一改动使检查语义从是否被引用收紧为是否被读取引用如赋值不再足以让声明免于未使用报错只有真正的读取如参与运算、作为参数传递、被返回等才能让声明被视为已使用。仅自调用的递归函数被视为未使用另一个值得注意的边界情况是递归函数。仅在自己的函数体内被调用的递归函数现在也被视为未使用function f() { f(); // Error: f is declared but its value is never read }函数f唯一的使用发生在它自身内部从外部视角看这个声明依然没有任何地方读取它的值因此被标记为未使用。这一规则与发布说明中描述的只写的引用现在会被标记未使用一致只要声明的值在程序其他部分从未被消费无论它内部如何自我引用都会被视为死代码。修复建议受影响的代码通常可以通过以下方式修复确实无用的声明直接删除对于只写不读的参数或局部变量如果确实不需要直接删除即可以下划线开头的参数对于需要保留签名如实现接口、回调函数但未使用的参数使用下划线前缀如_n是社区通行的约定TypeScript 对这类参数不会报未使用错误为属性补充读取点如果类属性确实需要在后续逻辑中使用补上读取它的代码即可消除报错。后续演进TypeScript 2.8 的调整需要留意的是这组选项的检查范围在后续版本仍在演进。本仓库的TypeScript 2.8 破坏性改动文档指出未使用的类型参数此前在--noUnusedLocals下报告从 2.8 起改由--noUnusedParameters报告。也就是说只读检查的语义框架在 2.6 建立后后续版本对报告归属做了进一步细化升级到 2.8 及以上版本时需要关注这一归类变化。环境上下文中的导出赋值禁止使用任意表达式第二项破坏性改动针对环境上下文ambient context即声明文件.d.ts与declare module环境模块声明中的导出语句。改动前任意表达式曾被允许在 TypeScript 2.5 及更早版本中下面的写法在环境上下文中不会被标记为错误declare module foo { export default some string; }为什么被禁止声明文件和环境模块通常禁止出现表达式原因在于typeof之类的意图不明确环境声明只描述类型形状不包含可执行代码。允许在export default后跟任意表达式与 TypeScript 在其他环境上下文中处理可执行代码的方式不一致。因此从 2.6 开始export default后面任何不是标识符identifier或限定名称qualified name如ns.name的内容都会被标记为错误。正确的声明方式为具有上述值形状的模块编写.d.ts的正确方法如下declare module foo { const _default: string; export default _default; }即先在环境模块内部用const声明一个带类型的值再将这个标识符作为默认导出。这样既保留了默认导出是一个 string 类型的值的类型语义又避免了在环境上下文中执行表达式。对编译器生成与手写声明的影响关键的一点是TypeScript 编译器自身生成的声明文件通过--declaration选项输出早已采用这种先声明常量再导出的形式因此这项改动只影响手工编写的.d.ts文件。如果你在项目中维护第三方库的类型声明或使用declare module为无类型的 npm 包补充类型升级后需要检查环境模块中的export default是否出现了表达式。关于环境模块声明的基本写法可以参考仓库中的声明文件介绍与模块声明模板其中对declare module的适用场景和结构有系统说明。升级注意事项小结将项目升级到 TypeScript 2.6或更高版本时建议按以下顺序自查检查编译选项确认tsconfig.json或命令行中noUnusedLocals/noUnusedParameters的开启状态。由于默认值为false未显式开启的项目不会受到第一项改动的影响开启后则需要注意只写不读的参数、局部变量和类私有属性会开始报错仅自调用的递归函数同样如此。扫描手写声明文件搜索.d.ts文件与declare module块中的export default确认其后是标识符或限定名称而非字符串拼接、函数调用等任意表达式。关注编译器生成物由--declaration生成的声明文件不受影响无需修改。完整的破坏性改动列表可在本仓库的Breaking Changes 总览中查看TypeScript 2.6 同期引入的其他新特性如--strictFunctionTypes、// ts-ignore注释等可参见TypeScript 2.6 发布说明。赞分享文档教程【免费下载链接】TypeScriptTypeScript 使用手册中文版翻译。http://www.typescriptlang.org项目地址https://gitcode.com/gh_mirrors/typ/TypeScript点击查看免费下载相关推荐Mitosis ESLint 规则 only-default-function-and-imports 完全指南约束组件文件只保留导入、默认导出与类型声明Mitosis ESLint 规则 only default function and imports 完全指南约束组件文件只保留导入、默认导出与类型声明 本前端代码生成开发工具低代码Gel/EdgeDB 链接属性Link Properties完全指南声明、约束、索引与增删改查实战Gel/EdgeDB 链接属性Link Properties完全指南声明、约束、索引与增删改查实战 本文基于 Gel/EdgeDB 官方文档《Link p数据库图数据库关系型数据库Penrose Style 形状系统详解声明语法、画布约束与类型检查机制Penrose Style 形状系统详解声明语法、画布约束与类型检查机制 本篇技术指南以 Penrose 官方文档 形状总览 https://link.git开发工具数据可视化上一篇终极指南如何3分钟免费实现PotPlayer字幕实时翻译下一篇PotPlayer字幕实时翻译终极指南3分钟免费实现外语视频无障碍观看创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考