web项目规范配置（husky、eslint、lint-staged、commit）

在现代Web开发中，规范配置有助于保持代码质量和一致性。通过使用Husky、ESLint、lint-staged和Commit规范，可以实现自动化的代码质量检查和规范化的提交流程。下面是详细的配置指南。

一、初始化项目

首先，确保你有一个Node.js项目。如果还没有，可以通过以下命令初始化：

mkdir my-web-project
cd my-web-project
npm init -y
​

 

 

二、安装必要的依赖

安装Husky、ESLint、lint-staged以及相关的依赖：

npm install --save-dev husky eslint lint-staged @commitlint/config-conventional @commitlint/cli
​

 

 

三、配置ESLint

ESLint是一个静态代码分析工具，用于识别和修复JavaScript中的问题。

1. 初始化ESLint配置：

   npx eslint --init
   ​

    

    

   按照提示选择你的配置选项。例如，可以选择检查语法、找到问题和强制代码风格，选择JavaScript模块、React等。

2. 创建或修改 .eslintrc.json文件，确保包含以下内容：

   {"env": {"browser": true,"es2021": true},"extends": ["eslint:recommended","plugin:react/recommended","plugin:@typescript-eslint/recommended"],"parserOptions": {"ecmaFeatures": {"jsx": true},"ecmaVersion": 12,"sourceType": "module"},"plugins": ["react","@typescript-eslint"],"rules": {"semi": ["error", "always"],"quotes": ["error", "double"]}
   }
   ​

    

    

四、配置lint-staged

lint-staged用于在提交代码之前运行ESLint，只检查暂存区中的文件。

1. 在 package.json中添加以下配置：

   "lint-staged": {"*.js": ["eslint --fix","git add"]
   }
   ​

    

    

五、配置Husky

Husky用于在Git hooks中执行自定义脚本，比如在提交代码之前运行ESLint。

1. 初始化Husky：

   npx husky install
   ​

    

    

2. 在 package.json中添加husky钩子：

   "husky": {"hooks": {"pre-commit": "lint-staged","commit-msg": "npx --no-install commitlint --edit $1"}
   }
   ​

    

    

3. 创建Husky配置文件：

   npx husky add .husky/pre-commit "npx lint-staged"
   ​

    

    

六、配置Commitlint

Commitlint用于强制执行规范化的提交消息格式。

1. 创建 commitlint.config.js文件，并添加以下内容：

   module.exports = {extends: ['@commitlint/config-conventional']
   };
   ​