在projen项目中优化TypeScript导入重复检测规则

背景介绍

在TypeScript项目开发中，模块导入是一个基础但重要的操作。随着项目规模扩大，如何规范和管理导入语句成为提升代码质量的关键。projen作为一个项目生成工具，其默认配置对TypeScript项目的导入规则有着直接影响。

问题分析

projen默认启用了no-duplicate-imports规则来防止重复导入，这在纯JavaScript项目中表现良好。但在TypeScript环境下，特别是当同时使用类型导入(import type)和值导入时，会出现误报情况。

例如以下合法且常见的TypeScript代码：

import type {MyType} from './hello'
import {myValue} from './hello'

会被错误地标记为重复导入违规，尽管这在TypeScript中是允许且推荐的做法。

技术原理

这个问题源于规则的设计差异：

1. no-duplicate-imports是ESLint核心规则，设计时未充分考虑TypeScript的类型系统特性
2. import/no-duplicates来自eslint-plugin-import插件，专门针对模块系统设计，能更好地区分类型导入和值导入

解决方案

projen团队决定将默认规则从no-duplicate-imports迁移到import/no-duplicates，这一变更带来以下优势：

1. 准确识别TypeScript的类型导入语法
2. 保持对真正重复导入的检测能力
3. 与现代TypeScript开发实践保持一致
4. 减少项目初始化后的额外配置需求

实施影响

这一变更将影响所有使用projen生成的TypeScript项目：

• 新项目将自动获得更合理的导入检查
• 现有项目升级后可能需要调整部分导入语句
• 开发者不再需要手动覆盖默认规则来解决误报问题

最佳实践建议

即使有了更智能的规则，开发者仍应注意：

1. 合理组织导入语句，将类型导入与值导入分组
2. 考虑使用导入别名(alias)来简化复杂导入
3. 定期运行lint检查保持代码整洁
4. 对于大型项目，可考虑进一步配置import/order规则来统一导入顺序

这一改进体现了projen对TypeScript生态的持续适配，使开发者能更专注于业务逻辑而非工具配置。