规范与静态检查65 条

eslint-disable 的合理边界

禁用注释是技术债：优先行级禁用（eslint-disable-next-line）并写明原因，避免文件级整片禁用；必要时统计禁用数量并定期审计。

粒度	行级 > 块级 > 文件级
要求	禁用必须写原因（-- 注释）

写法示例

// eslint-disable-next-line no-console -- 启动横幅必须输出到控制台
console.log(banner);

文件顶部的 eslint-disable 会关掉整份文件：评审时应要求改为行级或修复根因。

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌