lanyuanxiaoyao
ad87be6956
删除 start/build:web/format:check，简化 check 为 typecheck+lint+test 引入 eslint-plugin-prettier 将 Prettier 集成至 ESLint，统一质量检查入口 简化 lint-staged 配置，扩展 clean 清理范围至 dist/
26 lines
1.4 KiB
Markdown
26 lines
1.4 KiB
Markdown
## Purpose
|
|
|
|
定义 ESLint 与 Prettier 集成方案，通过 eslint-plugin-prettier 将 Prettier 格式检查统一纳入 ESLint 工作流，减少独立工具调用，提升开发体验。
|
|
|
|
## Requirements
|
|
|
|
### Requirement: ESLint 集成 Prettier 格式检查
|
|
|
|
项目 SHALL 通过 `eslint-plugin-prettier` 将 Prettier 格式规则集成为 ESLint 规则，使单次 `eslint .` 运行同时报告代码质量问题和格式问题。ESLint 配置 SHALL 注册 `plugin:prettier/recommended` 规则集，该规则集自动加载 Prettier 配置并禁用与 Prettier 冲突的 ESLint 规则。
|
|
|
|
#### Scenario: lint 运行同时检查格式
|
|
- **WHEN** 开发者运行 `bun run lint`
|
|
- **THEN** ESLint SHALL 同时报告代码质量违规和 Prettier 格式违规
|
|
|
|
#### Scenario: lint --fix 自动格式化
|
|
- **WHEN** 开发者运行 `eslint --fix` 或 lint-staged 自动触发 `eslint --fix`
|
|
- **THEN** ESLint SHALL 对可自动修复的代码质量问题和格式问题一并修正，包括调用 Prettier 重写文件格式
|
|
|
|
#### Scenario: Prettier 配置被正确读取
|
|
- **WHEN** ESLint 通过 eslint-plugin-prettier 检查代码格式
|
|
- **THEN** 检查结果 SHALL 与独立运行 `prettier --check` 的结果完全一致
|
|
|
|
#### Scenario: 不因集成降低 lint 性能
|
|
- **WHEN** 开发者运行 `bun run lint`
|
|
- **THEN** 运行时间 SHOULD 不超过原 `eslint .` + `prettier --check` 总耗时的 120%
|