前端进阶之旅前端进阶之旅
基础篇
进阶篇
高频篇
精选篇
手写篇
原理篇
面经篇
自检篇
每日一题
  • 综合
    • 综合题型
    • 其他问题
    • 设计模式
    • 思维导图
    • 学习路线
  • 前端基础
    • HTTP
    • 浏览器
    • 计算机基础
  • 进阶学习
    • NPM工作流
    • Docker
    • Canvas
    • Node学习指南
    • 前端综合文章
  • 其他
    • Handbook
    • 职场话题
    • CSS可视化
小程序题库
公众号动态
博客动态
开发者导航
基础篇
进阶篇
高频篇
精选篇
手写篇
原理篇
面经篇
自检篇
每日一题
  • 综合
    • 综合题型
    • 其他问题
    • 设计模式
    • 思维导图
    • 学习路线
  • 前端基础
    • HTTP
    • 浏览器
    • 计算机基础
  • 进阶学习
    • NPM工作流
    • Docker
    • Canvas
    • Node学习指南
    • 前端综合文章
  • 其他
    • Handbook
    • 职场话题
    • CSS可视化
小程序题库
公众号动态
博客动态
开发者导航

手把手带你基于ESLint 9+Husky+Prettier+Commitlint+Lint-staged配置前端开发规范

首页
2025-08-06 14:40:12
Front-End
ESLintPrettierHuskyCommitlintLint-staged前端工程化

在前端项目开发中,代码规范是保证代码质量和团队协作效率的基础。一个完善的代码规范体系不仅能统一团队成员的编码风格,还能在代码提交前自动检查问题,减少代码review的成本。

本文将手把手教你搭建一套完整的前端开发规范体系,基于ESLint 9新配置系统,配合Husky、Prettier、Commitlint、Lint-staged等工具,实现代码提交前的自动检查和格式化。

# 一、项目初始化与依赖安装

# 创建Next.js 16项目

npx create-next-app@latest my-app --typescript --tailwind --eslint
cd my-app
@前端进阶之旅: 代码已经复制到剪贴板

# 安装ESLint 9相关依赖

npm install eslint@9 @eslint/js@9 --save-dev
npm install typescript-eslint@8 --save-dev
npm install eslint-config-next@16 --save-dev
npm install eslint-plugin-simple-import-sort@12 eslint-plugin-unused-imports@4 --save-dev
npm install @eslint/compat@1 --save-dev
@前端进阶之旅: 代码已经复制到剪贴板

# 安装Prettier相关依赖

npm install prettier@3 prettier-plugin-tailwindcss@0.7 --save-dev
npm install eslint-config-prettier@10 --save-dev
@前端进阶之旅: 代码已经复制到剪贴板

# 安装Git钩子相关依赖

npm install husky@9 lint-staged@16 --save-dev
npm install @commitlint/cli@17 @commitlint/config-conventional@17 --save-dev
@前端进阶之旅: 代码已经复制到剪贴板

# 完整依赖清单

{
  "devDependencies": {
    "@commitlint/cli": "^17.7.2",
    "@commitlint/config-conventional": "^17.7.0",
    "@eslint/compat": "^1.4.1",
    "@eslint/eslintrc": "^3",
    &q
fe
  • 一、项目初始化与依赖安装
    • 创建Next.js 16项目
    • 安装ESLint 9相关依赖
    • 安装Prettier相关依赖
    • 安装Git钩子相关依赖
    • 完整依赖清单
  • 二、ESLint 9扁平化配置
    • 创建ESLint配置文件
    • package.json中添加ESLint脚本
  • 三、Prettier代码格式化配置
    • 创建Prettier配置文件
    • 创建Prettier忽略文件
    • package.json中添加Prettier脚本
  • 四、EditorConfig编辑器配置
  • 五、VSCode自动校验配置
    • 创建VSCode工作区配置
    • 配置说明
    • 推荐的VSCode扩展
    • 安装推荐的扩展
    • VSCode配置要点
  • 六、Commitlint提交规范配置
    • 创建Commitlint配置文件
    • 提交信息格式示例
  • 七、Lint-staged配置
    • 创建Lint-staged配置文件
  • 八、Husky Git钩子配置
    • 初始化Husky
    • 修改package.json中的prepare脚本
    • 创建commit-msg钩子
    • 创建pre-commit钩子
    • 完整的package.json脚本
  • 九、工作流程总结
    • 开发流程
    • 提交规范流程
  • 十、配置要点总结
    • ESLint 9配置要点
    • Prettier配置要点
    • Git钩子配置要点
  • 十一、常见问题
    • ESLint和Prettier冲突
    • 首次安装Husky不生效
    • Lint-staged执行失败

← React状态管理库选型指南:主流方案对比与实战推荐Next.js App Router开发避坑指南 常见错误与最佳实践 →