Biome Lint & TypeScript Type-Check 技能简介
用途 该技能用于修复 Biome 代码检查器错误、TypeScript/tsgo 类型检查错误,以及运行 lint/typecheck 相关工作流。适用于在 TypeScript 项目中处理 Biome 规则报错、类型错误和导入类型问题的场景。
主要能力 提供常见错误与修复方法的快速对照表,覆盖以下 Biome 规则与 TypeScript 错误:
- noImplicitAnyLet:为 let 变量添加类型,let x; 改为 let x: Type;
- noUnusedVariables:给未使用变量加下划线前缀,const foo 改为 const _foo;
- noUnusedFunctionParameters:在解构中重命名,{ param } 改为 { param: _param };
- noEmptyPattern:将 {} 替换为 _opts: object;
- noUnreachable:移除死代码或用块注释包裹;
- noInvalidUseBeforeDeclaration:将声明移到使用之前或提取为 const;
- TS2322:使用类型断言或过滤,如 as Record<string, string>;
- TS2345:使用非空断言或默认值,如 value! 或 value ?? '';
- TS7030:添加显式返回,如 return undefined;;
- TS2339:通过类型断言扩展,如 as Type & { prop?: T }。
使用方式 Biome Lint 工作流:
- 自动修复:pnpm biome lint ./src --write
- 检查剩余错误:pnpm biome lint ./src
- 修复导入类型问题:npx -y @biomejs/biome lint --only=style/useImportType ./src --write
TypeScript 检查:
- 单包:pnpm tsgo -p tsconfig.json --skipLibCheck --maxNodeModuleJsDepth 0 --noEmit
- 所有包:pnpm -r exec just typecheck
单包规则覆盖:可创建本地 biome.json 覆盖规则,配置中设置 "root": false、"extends": "//",并在 linter.rules 中指定 correctness 与 a11y 规则的等级为 warn。
biome-ignore 注释:可使用 // biome-ignore lint/<规则组>/<规则名>: <原因> 的形式忽略特定规则,例如忽略 noSelfCompare(NaN 检查)和 noConstructorReturn(proxy 模式)。
详细指南 该技能附带详细指南,包括 Biome 修复(各 Biome 规则的完整修复示例)、TypeScript 修复(TS 错误、ES 版本问题、跨包依赖),以及破坏性变更(Zod 4、vitest 4、react-router v7 等)。具体内容暂未提供。
适用场景 适用于使用 Biome 作为代码检查工具、并使用 tsgo 进行类型检查的 TypeScript 项目,尤其是需要批量修复 lint 错误、处理类型检查报错或配置单包规则覆盖的开发工作流。
限制 该技能聚焦于错误修复与工作流命令,具体修复效果取决于项目配置与代码上下文;官方文档与更详细说明暂未提供。