VSCode代码检查排除特定行：在代码中使用注释忽略警告
如何用 // @ts-ignore 忽略 TypeScript 单行检查
TypeScript的编译器（tsc）和VSCode的语言服务，默认都会执行严格的类型校验。但开发中难免遇到一些特殊情况：你明确知道某行代码是安全的，但编译器却固执地报错。比如调用一个未声明的全局变量，或者临时需要绕过某个类型不匹配的问题。这时候，最直接、最快速的解决方案，就是在报错行的正上方加上一行 // @ts-ignore 注释。
这里有个关键细节需要注意：// @ts-ignore 并非一把“万能钥匙”，它只会压制紧随其后的那一行代码所触发的TypeScript错误。如果它下面的那行代码本身没有报错，那么这条指令就会被VSCode静默忽略，不会产生任何副作用。
- 这条注释必须写在出错行的正上方，中间不能有空行隔开。
- 在较老的TypeScript版本中，不支持写成
// @ts-ignore: reason这种带说明的变体（虽然TS 4.6+开始支持，但VSCode的当前稳定版未必能同步识别）。 - 如果一行代码里包含了多个表达式（比如一个长长的链式调用），那么
// @ts-ignore会覆盖整行，无法做到只忽略其中的某一个环节。 - 在开启了
"allowJs": true的项目里，Ja vaScript文件也能识别这个注释，但前提是这个JS文件本身启用了类型检查（比如文件顶部有// @ts-check，或者在tsconfig.json中设置了"checkJs": true）。
为什么 // @ts-expect-error 比 @ts-ignore 更安全
如果说 // @ts-ignore 是“无条件屏蔽”，那么 // @ts-expect-error 就是“有条件放行”。它要求「被注释的下一行代码必须存在错误」，否则TypeScript编译就会失败，并提示 Unused @ts-expect-error comment。这个机制设计得非常巧妙，它能有效防止一种常见隐患：当你后来修复了代码中的错误，却忘记清理掉之前添加的ignore注释，导致潜在问题被长期掩盖。
它和 // @ts-ignore 的作用范围一样，都只作用于下一行，但多出的这层验证机制，让它更适合团队协作或需要长期维护的项目。
- 无论是VSCode的实时检查，还是运行
tsc --noEmit命令，都会校验该行是否真的存在错误。 - 注释的拼写必须完全正确，像
// @ts-expected-error这样的错误拼写会被完全无视。 - 它不能用于纯粹的声明语句（例如，
const x: number = 'hello';这种赋值类型错误可以使用，但单独的let x: number;声明则不行）。
ESLint 行级禁用要写两遍：/* eslint-disable */ + 规则名
这里有一个常见的混淆点：VSCode中飘红的波浪线，未必都来自TypeScript，很多其实是ESLint的规则在起作用。想忽略某一行的ESLint报警，光写 // @ts-ignore 是没用的，必须使用ESLint自己的语法：
// eslint-disable-next-line no-console console.log(x);
为了更精确，最好同时指定要禁用的具体规则名：
// eslint-disable-next-line @typescript-eslint/no-explicit-any const data: any = getData();
// eslint-disable-next-line同样必须写在目标行的上方，中间不能有空行。- 如果省略了规则名（比如只写
// eslint-disable-next-line），那么该行的所有ESLint规则都会被禁用，这种做法通常不推荐，因为它可能掩盖其他潜在问题。 - 要让这些注释生效，VSCode需要已经安装并启用了
dbaeumer.vscode-eslint插件，并且工作区已经正确配置了.eslintrc.js或eslint.config.js等配置文件。 - 特别注意规则名的大小写和格式：像
@typescript-eslint/no-explicit-any中的@符号和斜杠都不能少，拼写错误会导致规则禁用无效。
排除整个文件或目录，别靠注释硬扛
如果某个文件（比如自动生成的API客户端、或者对第三方库的补丁文件）里频繁出现需要忽略的错误，到处写 // @ts-ignore 就像打补丁，这通常意味着注释方案已经失效了。正确的做法是调整项目配置，而不是在代码里堆满忽略指令。
在TypeScript层面，可以在 tsconfig.json 的 exclude 字段里添加需要排除的路径；在ESLint层面，则可以通过 .eslintignore 文件或在 eslint.config.js 的 ignores 数组中进行声明。
- 需要理解的是，
tsconfig.json中的exclude并不影响类型的导入——它只是跳过这些文件的编译和检查。因此，被排除的文件中定义的类型，其他文件仍然可以正常 import 和使用。 - 路径的写法要相对于
tsconfig.json文件的位置，例如"exclude": ["src/generated/**/*"]。 - 在VSCode中，文件排除的优先级顺序通常是：用户设置里的
files.exclude> 工作区.vscode/settings.json>tsconfig.json中的 exclude。
真正棘手的是混合场景：同一行代码既触发了TypeScript的类型错误，又违反了ESLint的代码规范。这时候，你就得“双管齐下”，同时写上 // @ts-ignore 和 // eslint-disable-next-line。两条注释的先后顺序无所谓，但缺了任何一个，对应的那条红色波浪线就依然会顽固地留在那里。
