如何将现有TS项目的TSLint规则导入SonarQube TypeScript插件？

我明白你的困扰——SonarQube官方的TypeScript插件确实没法直接和项目里的TSLint规则一一对应，但我们可以通过生成TSLint检查报告并让SonarQube读取报告的方式，实现基于项目现有TSLint规则的代码分析。具体操作步骤如下：

1. 生成TSLint JSON格式报告 #

在你的TypeScript项目根目录下，执行TSLint命令时指定输出JSON格式的报告文件。命令示例：

tslint -c tslint.json --format json --out tslint-report.json 'src/**/*.ts'

• tslint.json：替换成你项目实际使用的TSLint配置文件路径
• src/**/*.ts：根据你的项目结构调整要扫描的文件范围，比如如果有test目录也需要检查，就改成src/**/*.ts test/**/*.ts

2. 配置SonarQube读取报告 #

在你的项目配置文件sonar-project.properties中，添加以下配置项，告诉SonarQube去哪里找TSLint的报告：

sonar.typescript.tslint.reportPaths=tslint-report.json

如果是通过SonarQube UI配置项目，也可以在项目的「分析范围」或「配置」页面找到对应的选项，填入报告文件路径。

3. 优化SonarQube规则集（可选但推荐） #

为了避免重复告警（SonarQube自身规则和TSLint规则可能有重叠），建议你调整项目的SonarQube质量配置：

• 登录SonarQube后台，进入你的项目
• 进入「质量配置」页面，复制默认的TypeScript规则集（不要直接修改默认规则集）
• 在复制后的自定义规则集中，禁用那些和TSLint重复的规则，只保留你需要的规则项

4. 运行SonarQube分析 #

执行SonarScanner命令启动代码分析，示例命令：

sonar-scanner -Dsonar.projectKey=your-project-key -Dsonar.sources=src -Dsonar.host.url=http://your-sonarqube-instance-url -Dsonar.login=your-auth-token

分析完成后，你就能在SonarQube的项目面板中看到基于项目TSLint规则的检查结果了。

最后提个小建议：TSLint已经被官方弃用，后续如果项目有迁移计划，转到ESLint会更适配SonarQube的生态——SonarQube的TypeScript插件对ESLint的支持更完善，能直接导入ESLint配置文件，操作会更简单。

内容的提问来源于stack exchange，提问作者XtianGIS