03.6.1.4 Lint、类型检查与提交规范
所属:全栈开发面试题库 / 03 前端基础与 Web 开发 / 03.6 前端工程化 / 03.6.1 工程化与构建
03.6.1.4-001 前端代码规范体系由哪些部分组成?
一句话结论
规范体系包含静态检查(ESLint/Stylelint)、代码格式化(Prettier)、类型检查(tsc)与提交信息规范(commitlint),配合 Git 钩子在提交前与 CI 中分层执行,保证风格一致与问题前置拦截。
概念解释
- 静态检查:代码质量与规则问题。
- 格式化:缩进、引号、换行等风格。
- 类型检查:类型一致性校验。
- 提交规范:消息格式与可追溯性。
原理流程
- 本地编辑器实时提示。
- 提交前钩子检查暂存区。
- CI 全量跑规范与类型门禁。
代码 / 示例
规范链路:
编辑器实时提示
提交前:lint-staged + 钩子
CI:ESLint / Stylelint / tsc / commitlint
常见误区
- 误区:规范只是统一缩进风格;正解:还包括质量缺陷、类型安全与提交可追溯性。
- 误区:CI 跑规范即可;正解:提交前拦截反馈更快,问题不应堆积到流水线。
追问
- Q:各规范工具职责会重叠吗? A:格式化与部分风格规则可能冲突,需明确分工并关闭重叠规则。
- Q:规范规则从哪里维护? A:共享配置包或仓库内配置,团队统一评审后调整。
03.6.1.4-002 ESLint 配置与规则如何组织?
一句话结论
ESLint 配置声明环境、解析器、插件与规则集合;规则按 error/warn/off 分级,共享配置复用团队约定,项目内按需覆盖;规则目标是捕获潜在缺陷与风格不一致。
概念解释
- 解析器:解析 TS/JSX 等语法。
- 插件:提供规则集合。
- 规则分级:error 阻断、warn 提示、off 关闭。
原理流程
- 加载配置与共享预设。
- 解析源码匹配规则。
- 报告问题级别,按门禁策略阻断或提示。
代码 / 示例
{
"root": true,
"env": { "browser": true, "es2022": true },
"extends": ["eslint:recommended"],
"rules": {
"no-unused-vars": "error",
"semi": ["error", "always"]
}
}
常见误区
- 误区:规则开得越多越严格越好;正解:规则需评估误报与维护成本,避免噪声淹没真实问题。
- 误区:ESLint 能做类型检查;正解:类型一致性由 tsc 负责,ESLint 规则是静态语法层面检查。
追问
- Q:TS 项目 ESLint 用什么解析器? A:类型语言解析插件链,具体包名与版本按项目配置确认。
- Q:规则临时关闭怎么写? A:行内注释禁用规则,需说明原因并控制使用范围。
03.6.1.4-003 ESLint 插件与共享配置如何复用?
一句话结论
插件提供规则实现,共享配置预设环境、插件与规则组合;团队抽取共享配置包在多项目复用,项目内只覆盖差异规则,避免每个仓库重复维护规则清单。
概念解释
- 插件:规则来源。
- 共享配置:可继承的规则预设。
- 覆盖:项目级规则叠加在预设之上。
原理流程
- 共享配置沉淀团队规则约定。
- 各项目 extends 引用配置。
- 项目内局部覆盖必要差异。
代码 / 示例
{
"extends": ["@scope/eslint-config", "plugin:react/recommended"],
"rules": { "react/prop-types": "off" }
}
常见误区
- 误区:每个项目从零写规则;正解:通用约定抽共享配置,减少重复与不一致。
- 误区:覆盖规则会继承全部插件;正解:继承的是配置预设,插件按需引入。
追问
- Q:共享配置如何发布维护? A:作为独立包版本化发布,项目按版本锁定升级。
- Q:规则冲突如何解决? A:后加载配置覆盖前者,调整 extends 顺序与规则级别。
03.6.1.4-004 Prettier 与 ESLint 如何分工?
一句话结论
Prettier 负责代码格式化(缩进、引号、换行、折行),ESLint 负责质量规则与部分风格规则;二者重叠的风格规则应在 ESLint 中关闭,避免自动修复互相打架。
概念解释
- 格式化:确定性风格输出,不做质量判断。
- 质量规则:缺陷、未使用变量、可疑写法。
- 分工:关闭重叠规则让 Prettier 管风格。
原理流程
- Prettier 按配置统一格式。
- ESLint 检查质量规则。
- 重叠风格规则在 ESLint 关闭。
代码 / 示例
Prettier:缩进、引号、分号、折行、对象括号
ESLint:未使用变量、可疑比较、最佳实践
冲突规则:ESLint 中关闭,交给 Prettier
常见误区
- 误区:ESLint 自动修复能替代 Prettier;正解:格式化决策由 Prettier 统一,避免规则间格式不一致。
- 误区:两者规则越多越好;正解:重叠规则会导致修复结果来回变化。
追问
- Q:项目如何安装两者配合? A:引入 ESLint 与 Prettier 配置,关闭冲突规则,具体插件组合按版本确认。
- Q:提交时格式由谁执行? A:lint-staged 运行格式化与检查,编辑器保存时亦可自动格式化。
03.6.1.4-005 Stylelint 检查哪些样式规范?
一句话结论
Stylelint 校验 CSS/SCSS 等样式规则:属性顺序、合法值、重复选择器、废弃属性与命名风格;配合框架/预处理器插件覆盖具体语法,保证样式代码一致与可维护。
概念解释
- 规则:属性顺序、命名、合法值。
- 插件:预处理器与框架语法支持。
- 分级:error/warn/off 同 ESLint。
原理流程
- 加载样式规则预设。
- 解析样式文件匹配规则。
- 报告问题并按门禁处理。
代码 / 示例
{
"extends": ["stylelint-config-standard"],
"rules": {
"selector-class-pattern": "^[a-z][a-z0-9-]+$"
}
}
常见误区
- 误区:样式不需要静态检查;正解:重复选择器、废弃属性与命名混乱同样影响维护。
- 误区:Stylelint 能替代预处理器编译;正解:它只做规则检查,编译由预处理器完成。
追问
- Q:SCSS 规则如何启用? A:引入对应语法插件,具体包名按 Stylelint 版本确认。
- Q:样式命名规范如何落地? A:规则限定类名模式,配合团队约定的 BEM/模块方案。
03.6.1.4-006 类型检查门禁如何接入构建流程?
一句话结论
独立运行 tsc --noEmit 做类型检查,不依赖打包转译;在提交前与 CI 中先跑类型门禁,类型错误阻断构建,避免类型问题流入产物与线上。
概念解释
- noEmit:只检查不输出 JS。
- 独立环节:与打包转译分离。
- 门禁:错误阻断后续流程。
原理流程
- 运行 tsc 读取 tsconfig 检查类型。
- 类型错误输出并返回非零退出码。
- CI/提交钩子据此阻断。
代码 / 示例
{
"scripts": {
"typecheck": "tsc --noEmit",
"ci": "npm run typecheck && npm run lint && npm run build"
}
}
常见误区
- 误区:打包成功类型就正确;正解:打包剥离类型不校验,必须独立跑 tsc。
- 误区:类型检查可放到生产构建之后;正解:类型问题应在提交与 CI 早期拦截。
追问
- Q:库项目类型声明何时生成? A:发布前 tsc 输出
.d.ts,与类型检查流程分开。 - Q:存量项目类型报错太多怎么办? A:按文件逐步严格化,先放宽配置再收敛,不一次性阻断。
03.6.1.4-007 Git 钩子与 lint-staged 如何配合?
一句话结论
Husky 管理 Git 钩子(如 pre-commit),lint-staged 只对暂存区文件运行检查与修复;避免全量扫描拖慢提交,问题在提交前被拦截并自动修复可修复项。
概念解释
- 钩子:Git 生命周期触发脚本。
- lint-staged:过滤暂存区文件。
- 前置拦截:提交前发现问题。
原理流程
- 配置 pre-commit 钩子。
- 钩子调用 lint-staged。
- 仅对暂存文件跑 lint/格式化,失败阻断提交。
代码 / 示例
{
"lint-staged": {
"*.{ts,tsx,vue}": ["eslint --fix", "prettier --write"],
"*.{css,scss}": ["stylelint --fix"]
}
}
常见误区
- 误区:钩子跑全量项目检查;正解:lint-staged 只处理暂存文件,全量检查放 CI。
- 误区:自动修复后无需复查;正解:可修复项自动处理,剩余问题需人工确认。
追问
- Q:Husky 与原生 Git 钩子区别? A:Husky 管理钩子脚本与配置,跨团队统一钩子约定,具体安装方式按版本确认。
- Q:钩子失败如何绕过? A:按团队规范不建议随意跳过,确需例外走审批并记录原因。
03.6.1.4-008 约定式提交与 commitlint 如何规范消息?
一句话结论
约定式提交规定消息格式(类型、范围、描述),如 feat: 新增购物车;commitlint 校验提交信息符合规范,便于生成变更日志与追溯变更类型。
概念解释
- 类型:feat/fix/docs/refactor/chore 等。
- 范围:影响模块。
- 描述:简洁说明变更。
原理流程
- 提交信息按格式书写。
- commitlint 钩子校验格式。
- 不合规提交被阻断,合规信息用于变更日志。
代码 / 示例
格式:<type>(<scope>): <subject>
示例:feat(cart): 新增数量步进器
类型:feat 新功能 / fix 修复 / docs 文档 / refactor 重构 / chore 杂务
常见误区
- 误区:提交信息随便写不影响项目;正解:规范消息支撑版本日志、变更追溯与发布决策。
- 误区:commitlint 检查代码质量;正解:它只校验消息格式,代码检查由 lint 完成。
追问
- Q:提交类型如何对应版本号? A:feat 通常对应次版本,fix 对应补丁,具体语义化策略按发布流程确认。
- Q:多行提交信息如何规范? A:标题行简短,正文说明动机与影响,footer 记录关联事项。
03.6.1.4-009 EditorConfig 解决什么问题?
一句话结论
EditorConfig 用统一配置声明缩进、换行、字符集与末尾换行,编辑器按配置保持基础风格一致,跨编辑器与操作系统减少格式差异。
概念解释
- 基础风格:缩进宽度、空格/制表符、换行符。
- 跨编辑器:多种编辑器读取同一配置。
- 与 Prettier 分工:EditorConfig 管基础缩进,Prettier 管完整格式化。
原理流程
- 仓库根放置
.editorconfig。 - 编辑器读取配置应用基础格式。
- 提交前格式化工具统一细节风格。
代码 / 示例
root = true
[*]
charset = utf-8
indent_style = space
indent_size = 2
end_of_line = lf
insert_final_newline = true
常见误区
- 误区:EditorConfig 能替代 Prettier;正解:它只覆盖基础编辑器配置,完整格式化仍需 Prettier。
- 误区:换行符由编辑器自动统一;正解:需配置与 .gitattributes 约定配合,避免跨平台差异。
追问
- Q:EditorConfig 与 .gitattributes 关系? A:前者指导编辑器,后者约束 Git 换行符处理,二者配合保证跨平台一致。
- Q:不同文件类型缩进不同怎么办? A:按文件通配符分段配置。
03.6.1.4-010 规范在 CI 中按什么顺序执行?
一句话结论
CI 通常先安装依赖与类型检查,再跑 ESLint/Stylelint 等静态检查,最后构建产物;类型与规范门禁通过后才进入打包,避免在已知错误代码上浪费构建资源。
概念解释
- 早期门禁:类型与规范先跑。
- 构建在后:通过检查再打包。
- 失败短路:前序失败阻断后续。
原理流程
- 安装依赖并恢复缓存。
- 类型检查 → 静态检查。
- 检查通过后构建与测试。
代码 / 示例
CI 步骤:
安装依赖 → typecheck → lint/stylelint → 测试 → build
常见误区
- 误区:先构建再检查规范;正解:规范门禁前置,避免错误代码进入打包流程。
- 误区:CI 只跑构建;正解:类型与静态问题需在流水线显式拦截。
追问
- Q:CI 检查与本地钩子重复吗? A:本地快速反馈暂存区,CI 全量兜底,两者职责不同。
- Q:检查耗时如何优化? A:增量检查、缓存与并行步骤,按项目规模调整。
03.6.1.4-011 自动修复与人工审查的边界是什么?
一句话结论
格式与可安全转换的问题由工具自动修复;逻辑缺陷、架构取舍与规则例外需要人工审查;自动修复不替代代码评审,工具只处理确定性规则问题。
概念解释
- 自动修复:格式、导入排序等确定性变换。
- 人工审查:业务逻辑、复杂度、设计合理性。
- 例外:规则禁用需说明原因。
原理流程
- 工具自动修复可修复项。
- 剩余问题人工判断。
- 评审关注工具无法覆盖的设计与逻辑。
代码 / 示例
自动修复:缩进、引号、分号、导入排序
人工审查:业务逻辑、状态设计、性能取舍、规则例外
常见误区
- 误区:lint 通过就可以合并;正解:工具只覆盖规则内问题,逻辑与设计仍需评审。
- 误区:所有警告都必须修复;正解:warn 级别提示需评估,合理例外可记录说明。
追问
- Q:规则例外如何留痕? A:行内注释说明禁用原因,避免无理由关闭规则。
- Q:自动修复可能引入问题吗? A:可能,修复后需复查变更内容。
03.6.1.4-012 规则配置如何继承与覆盖?
一句话结论
配置按 extends 顺序继承预设规则,项目内 rules 覆盖冲突项;后加载配置覆盖前者,规则分级可调整 error/warn/off,共享配置沉淀通用约定。
概念解释
- 继承:extends 引入预设。
- 覆盖:rules 局部调整。
- 顺序:配置加载顺序决定覆盖关系。
原理流程
- 加载基础预设。
- 叠加插件与项目规则。
- 冲突规则按后加载覆盖。
代码 / 示例
{
"extends": ["eslint:recommended", "@scope/config"],
"rules": {
"no-console": "warn"
}
}
常见误区
- 误区:项目规则覆盖继承全部配置;正解:只覆盖同名规则,其他继承项保留。
- 误区:覆盖规则无需说明;正解:偏离团队约定需在评审中说明原因。
追问
- Q:如何查看最终生效规则? A:工具提供规则检查命令,输出生效配置,具体命令按工具版本确认。
- Q:多环境规则差异怎么处理? A:按配置文件或覆盖项区分开发/生产检查严格度。
03.6.1.4-013 报错级别 error、warn、ignore 如何选择?
一句话结论
error 阻断提交/CI,用于必须修复的缺陷;warn 提示不阻断,用于待改进或观察项;ignore 通过注释或配置排除,仅限明确例外;级别应随团队规范收敛。
概念解释
- error:门禁阻断。
- warn:提示记录。
- ignore:排除检查并说明原因。
原理流程
- 评估问题严重性与修复成本。
- 必须修复设 error,观察项设 warn。
- 例外项记录 ignore 原因。
代码 / 示例
error:未使用变量、可疑空判断
warn:console 语句、风格观察项
ignore:明确例外,注释说明原因
常见误区
- 误区:所有问题都设 error 最严格;正解:误报噪声会降低门禁可信度。
- 误区:ignore 可以随意使用;正解:排除规则需评审留痕,避免掩盖真实问题。
追问
- Q:存量 warn 如何收敛? A:建立清单逐步修复,达标后升级为 error。
- Q:规则关闭会影响团队一致性吗? A:偏离约定需评审,共享配置统一维护。
03.6.1.4-014 Monorepo 中规范如何共享?
一句话结论
公共规范配置抽为内部包或根级配置,各子包继承复用;根目录统一钩子与 CI 检查,子包只覆盖差异规则,避免每个包重复维护 lint/格式化配置。
概念解释
- 共享配置:根级或内部包沉淀规则。
- 继承:子包 extends 引用。
- 统一钩子:根 Git 钩子与流水线检查。
原理流程
- 根目录维护共享规范配置。
- 子包继承配置并局部覆盖。
- 根 CI 统一跑全量规范检查。
代码 / 示例
Monorepo 规范:
根 ESLint/Prettier/tsconfig 配置
子包继承 + 局部覆盖
根钩子与 CI 统一执行
常见误区
- 误区:每个子包独立一套规则;正解:共享约定减少重复与跨包不一致。
- 误区:子包可随意放宽规则;正解:偏离共享配置需在根配置评审中统一。
追问
- Q:共享配置如何版本化? A:作为内部包发布,子包按版本锁定升级。
- Q:子包类型检查如何组织? A:根 tsconfig 基础配置,子包 extends 继承。
03.6.1.4-015 提交前检查与暂存区如何工作?
一句话结论
提交前钩子只检查 git 暂存区已暂存文件,配合 lint-staged 过滤路径;未暂存修改不参与本次检查,全量问题由 CI 兜底,兼顾提交速度与质量。
概念解释
- 暂存区:本次提交纳入的文件。
- 增量检查:只处理暂存文件。
- 全量兜底:CI 扫描全部代码。
原理流程
- 文件加入暂存区。
- pre-commit 钩子读取暂存清单。
- 仅对暂存文件检查修复,失败阻断提交。
代码 / 示例
提交流程:
git add → 钩子读取暂存文件 → lint-staged 检查
失败 → 修复后重新 add
CI 全量复核
常见误区
- 误区:未暂存文件也应在提交前检查;正解:本次提交不纳入的修改不阻塞,避免干扰进行中工作。
- 误区:钩子检查可替代 CI 全量;正解:本地只覆盖暂存区,未暂存与历史代码由 CI 复核。
追问
- Q:检查通过但工作区有未修复问题怎么办? A:不影响本次提交,后续在 CI/评审中处理。
- Q:如何查看暂存文件清单? A:git 状态命令列出暂存区文件,具体命令按 Git 版本确认。
03.6.1.4-016 历史代码如何渐进引入规范?
一句话结论
存量项目不一次性开启全部严格规则:先落地格式化与基础 lint,类型检查逐步放宽到严格模式,存量问题列入清单分批修复,新代码受新规则约束,避免大重构阻断迭代。
概念解释
- 渐进引入:规则分批开启。
- 存量清单:历史问题登记跟踪。
- 新代码约束:新增代码遵循新规则。
原理流程
- 先统一格式化消除风格噪声。
- 开启低风险基础规则。
- 类型严格度与高质量规则分批收敛。
代码 / 示例
渐进路径:
Prettier 统一格式
ESLint 基础规则
tsc 从宽松到严格
存量问题清单分批修复
常见误区
- 误区:一次性开启所有严格规则;正解:存量报错洪流会阻断迭代,需分批收敛。
- 误区:新代码可以沿用旧风格;正解:新增代码应遵循已落地规则。
追问
- Q:存量违规如何隔离? A:按文件/目录临时排除,清单跟踪修复后移除排除。
- Q:类型严格化怎么推进? A:先关闭严格报错门限,按模块开启 strict 选项。
03.6.1.4-017 测试与规范在流水线中是什么位置?
一句话结论
规范与类型门禁前置,测试在检查通过后执行;单元/集成测试验证行为,构建产物作为最终交付;流水线按依赖顺序短路失败,避免在未通过检查的代码上跑后续阶段。
概念解释
- 门禁顺序:类型 → 规范 → 测试 → 构建。
- 测试:行为正确性验证。
- 构建:产物生成与优化。
原理流程
- 依赖安装与缓存恢复。
- 类型与静态检查。
- 测试通过后构建产物。
代码 / 示例
流水线:
安装 → typecheck → lint → 测试 → build → 发布
常见误区
- 误区:测试通过即可忽略规范;正解:规范与类型是独立门禁,需分别通过。
- 误区:构建先于测试;正解:行为验证通过再打包,减少无效构建。
追问
- Q:测试类型有哪些? A:单元测试、集成测试、E2E,按层级在流水线分层执行。
- Q:流水线失败如何定位? A:按阶段日志判断是类型、规范、测试还是构建失败。
03.6.1.4-018 规范工具有哪些版本边界需要标注待确认?
一句话结论
ESLint/Prettier/Stylelint/Husky/lint-staged/commitlint 的配置格式、钩子安装方式与规则集随版本演进;涉及具体默认行为与支持范围的结论标注待确认,对照项目版本与官方文档验证。
概念解释
- 版本差异:配置格式、命令、废弃插件。
- 生态:规则集与解析插件更新。
- 验证:版本号 + 文档 + 最小复现。
原理流程
- 记录规范工具版本。
- 对照文档核对配置与命令。
- 最小样例验证钩子与检查行为。
代码 / 示例
待确认项:
- 钩子安装与配置方式
- 解析插件与规则集兼容范围
- 命令行参数与默认级别
验证点:版本号 + 官方文档 + 最小复现样例
常见误区
- 误区:规范配置跨版本通用;正解:工具升级可能改变配置格式与默认规则。
- 误区:教程插件可直接接入;正解:需核对对应工具版本兼容性。
追问
- Q:如何确认工具版本? A:读 package.json 与 lockfile 实际安装版本。
- Q:升级规范工具回归哪些项? A:钩子触发、规则报告与 CI 门禁结果。