Mehrere wissenswerte Frontend-Formatierungstools im Jahr 2023 [Zusammenfassung]

In der großen Front-End-Ära entstehen ständig verschiedene Front-End-Toolketten, darunter eslint, prettier, husky, commitlint usw. Manchmal ist es ein Problem, wenn es zu viele Dinge gibt, die jeder Frontend-Entwickler beherrschen muss Board???eslint, prettier, husky, commitlint 等, 东西太多有的时候也是trouble???,怎么正确的使用这个是每一个前端开发者都需要掌握的内容，请上车???

eslint

本次前端工程化的项目是基于react来的，vue用户也是同样的道理，只是有个别的依赖包不一样。

使用eslint的生态链来规范开发者对js/ts基本语法的规范。防止团队的成员乱写.

这里主要使用到的eslint的包有以下几个：

"eslint": "^8.33.0",  // 这个是eslint的主包
"eslint-plugin-react": "^7.32.2",  // 这是react基于eslint来做的语法规范插件
"eslint-plugin-react-hooks": "^4.6.0", // 这是 react-hooks 语法基于eslint做的插件
"@typescript-eslint/eslint-plugin": "^5.50.0",  // typescript 基于eslint来做的插件
"@typescript-eslint/parser": "^5.50.0",  // typescript 基于eslint做的语法解析器，使得eslint可以约束ts语法

使用的以下语句来按照依赖：

pnpm i eslint eslint-plugin-react eslint-plugin-react-hooks @typescript-eslint/parser @typescript-eslint/eslint-plugin -D

接下来需要对eslint的规范写入配置文件中，可以在项目的根目录下面建立一个 .eslintrc.cjs

module.exports = {
    'env': {
        'node': true,   // 标志当前的环境，不然使用module.exports 会报错
        'es2021': true
    },
    extends: [
      'eslint:recommended',  // 使用eslint推荐的语法规范
      'plugin:react/recommended',  // react推荐的语法规范
      'plugin:@typescript-eslint/recommended' // ts推荐的语法规范
    ],
    parser: '@typescript-eslint/parser',  // 使用解析器来解析ts的代码，使得eslint可以规范ts的代码
    parserOptions: {
      ecmaFeatures: {
        jsx: true  // 允许使用jsx的语法
      },
      ecmaVersion: 'latest',  // es的版本为最新版本
      sourceType: 'module'  // 代码的模块化方式，使用module的模块方式
    },
    plugins: ['react', '@typescript-eslint', 'react-hooks'],  // 使用对应的react, react-hooks, @typescript-eslint 等插件
    rules: {
      quotes: ['error', 'single'],  // 配置单引号的规则，如果不是单引号，报错
      semi: 'off',  //  不需要使用分号；
      'react/react-in-jsx-scope': 'off'  // 在jsx中不需要导入 react的包
    }
  }

接下来在package.json 的 scripts 中加入一条命令

"lint": "eslint --ext .ts,.tsx,.js,.jsx ./" // 使用eslint 规范 ts,tsx,js,jsx的代码

效果

代码中的不规范的格式就暴露出来了，现在可以来修复并且格式化代码。但是在格式化代码方面，prettier做的更好点，所以咱们来使用 prettier来进行代码格式化

prettier

prettier 是一款开源的代码格式化包，支持多种代码编写工具，常见的 vscode, webstorm 等，他都是支持的，那么怎么给他集成起来呢？

使用下面语句来安装依赖：

pnpm i prettier eslint-plugin-prettier eslint-config-prettier

下面来解释下，这些包是干啥用的，不然稀里糊涂安装了它

"prettier": "^2.8.3",  // prettier 主包
"eslint-config-prettier": "^8.6.0",  // eslint 和prettier的共同配置
"eslint-plugin-prettier": "^4.2.1",  // 在eslint当中，使用prettier为插件，才能一起使用

安装好依赖后，咱们还需要在 eslitrc.cjs中加入prettier的配置如下：

{
 extends:[
 ...,
+ 'prettier', // prettier
+ 'plugin:prettier/recommended' // prettier推荐的配置  
 ],
+ plugins:[...,'prettier'],
rules: {
+    'prettier/prettier': 'error', // eslint 和prettier 用prettier的错误
    }
}

接下来在package.json中添加一段脚本

+ "prettier": "eslint --fix --ext .ts,.tsx,.js,.jsx --quiet ./"

此时，咱们还需要配置哪些文件是不需要进行代码格式化的，所以在根目录下面建立 .prettierignore增加如下内容：

node_modules
package.json
pnpm-lock.yaml
dist

效果

修复成功，但是这里还报了一个警告，这个的解决办法如下：

在eslintrc.cjs的最后增加上一段配置如下：

+ settings: {
+    react: {
+      version: 'detect'
+    }
+  }

配置自动格式化

每一次都需要在终端执行脚本，有点小复杂，能不能设置自动格式化呢？

答案是可以的

1. 打开设置

2. 输入fomatter,然后选中文本编译器后，选择prettier-Code formatter

3. 然后搜索 formate on save,选中即可

就可以出现下面的效果了：

按 ctrl + s 会自动的格式化代码哦???

husky

到上面为止，代码的格式化工具和代码规范检查就好了,这是本地的，所以咱们还需要在提交代码的时候，在commit 之前，进行 prettier 操作，就不需要手动啦。

使用脚本安装下面的依赖包

pnpm i husky -D

我们在终端通过 npx husky install 来初始化 husky

我们还需要生成pre-commit钩子的时候来执行npm run lint

npx husky add .husky/pre-commit "npm run lint"  // 这句话的意思是说，在commit之前先执行 npm run lint脚本

安装完成后，会在 .husky 目录中新增一个文件 pre-commit

需要注意的是，我们需要在 package.json 注册 prepare 命令，在项目进行 pnpm i 之后就行 Huksy

eslint

Dieses Front-End-Engineering-Projekt basiert auf React. Dasselbe gilt für Vue-Benutzer, mit der Ausnahme, dass einzelne Abhängigkeitspakete vorhanden sind sind unterschiedlich. 🎜

🎜Verwenden Sie die ökologische Kette von eslint, um die grundlegende Syntax von js/ts für Entwickler zu standardisieren. Verhindern Sie, dass Teammitglieder zufällig schreiben. 🎜🎜Die wichtigsten hier verwendeten Eslint-Pakete sind die folgenden: 🎜

+ "prepare": "husky install"

🎜Verwenden Sie die folgenden Anweisungen, um die Abhängigkeiten zu befolgen: 🎜

pnpm i commitlint @commitlint/cli @commitlint/config-conventional -D

🎜 Als nächstes müssen Sie die Eslint-Spezifikationen in die Konfigurationsdatei schreiben Erstellen Sie eine .eslintrc.cjs im Stammverzeichnis des Projekts🎜

 "@commitlint/cli": "^17.4.2", // 规范提交信息
 "@commitlint/config-conventional": "^17.4.2",  // commitlint 常用的msg配置
 "commitlint": "^17.4.2" // commitlint 主包

🎜Dann fügen Sie den Skripten von package.json einen Befehl hinzu🎜

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

Effect🎜🎜

🎜Das unregelmäßige Format im Code wird angezeigt. Jetzt können Sie den Code reparieren und formatieren. Aber was die Formatierung des Codes angeht, leistet prettier einen besseren Job, also verwenden wir prettier, um den Code zu formatieren 🎜

#!/usr/bin/env sh . "$(dirname -- "rrreee")/_/husky.sh" - npm run lint + npx --no -- lint-staged🎜Zu diesem Zeitpunkt müssen wir auch konfigurieren, welche Dateien dies nicht tun müssen mit Code formatiert werden. Erstellen Sie also .prettierignore im Stammverzeichnis und fügen Sie den folgenden Inhalt hinzu: 🎜rrreee

🎜🎜Die Reparatur war erfolgreich, aber Hier wurde eine Warnung gemeldet. So lösen Sie das Problem: 🎜🎜Fügen Sie die vorherige Konfiguration am Ende von eslintrc.cjs wie folgt hinzu: 🎜rrreee🎜🎜

Automatische Formatierung konfigurieren

🎜Sie müssen sich jedes Mal am Terminal anmelden. Die Ausführung des Skripts ist etwas kompliziert. Kann ich die automatische Formatierung einrichten? 🎜

🎜Die Antwort ist ja🎜

1. Einstellungen öffnen

🎜🎜

2. Geben Sie formater ein und wählen Sie Nachher Text Compiler, wählen Sie prettier-Code formatter

🎜🎜

3. Dann suchen Sie nach dem Code formate on save >, wähle es aus

🎜🎜🎜Der folgende Effekt wird angezeigt: 🎜🎜🎜

🎜Drücken Sie Strg + s und der Code wird automatisch formatiert???🎜 blockquote>

husky

🎜Bisher sind das Codeformatierungstool und die Codespezifikationsprüfung völlig in Ordnung. Dies ist lokal, daher müssen wir den Code noch senden, wenn wir schönere Vorgänge ausführen, bevor wir ihn festschreiben. Es besteht keine Notwendigkeit, dies manuell zu tun. 🎜🎜Verwenden Sie das Skript, um die folgenden Abhängigkeitspakete zu installieren🎜rrreee🎜Wir initialisieren husky im Terminal über npx husky install🎜🎜🎜🎜Wir müssen auch den pre-commit Hook Beim Ausführen von <code>npm run lint🎜rrreee🎜Nach Abschluss der Installation wird eine neue Datei pre-commit🎜🎜🎜🎜Es sollte beachtet werden, dass wir >package.json Registrieren Sie den Befehl prepare, nachdem das Projekt pnpm i ist. Der Befehl lautet wie folgt: 🎜

+ "prepare": "husky install"

上面咱们是自己手动 npx husky install的，我们需要让后面使用咱们配置的人自动来初始化 husky

但是大家如果再深入一步，就会想到???。既然我内容都管控好了，是不是需要把 commit -m 'xxx' 中的msg 也管控下呀???

使用下面的命令来安装包：

pnpm i commitlint @commitlint/cli @commitlint/config-conventional -D

包意思解析

 "@commitlint/cli": "^17.4.2", // 规范提交信息
 "@commitlint/config-conventional": "^17.4.2",  // commitlint 常用的msg配置
 "commitlint": "^17.4.2" // commitlint 主包

安装好这些包后，需要在根目录添加一个 .commitlintrc.cjs来配置咱们的commitlint的配置:

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

有了这些配置，commit是否生效呢？

答案是 no, 还需要在git hooks中添加一个方法

在终端执行下面的命令

npx husky add .husky/commit-msg 'npx --no-install commitlint --edit "$1"'

然后会在.husky中生成一个新的文件commit-msg

效果

接下来就是见证奇迹的时刻???

对于乱写commit 信息就过不了哦???

lint-staged

对于细心的同学可能会发现，我们每一次提交都会 prettier整个目录的所有问题，大大的降低了咱们编码的速度。所以咱们还需要做一件事情，那就是 只格式化需要提交的代码，其他的就不需要格式化了

使用下面命令安装依赖

pnpm i lint-staged -D

然后在package.json中新增如下内容

+ "lint-staged": {
+     "**/*.{js,jsx,tsx,ts}": [  
+          "eslint --fix"
+       ]
+    }

上面那段脚本的意思是 只对 .js,.jsx, .ts,.tsx 后缀文件进行eslint的修复，其他的就不进行格式化和修复了

有了这个，还需要对 pre-commit 这个钩子就行修改内容

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

- npm run lint
+ npx --no -- lint-staged

如此就大功告成啦???

（学习视频分享：web前端入门）

Das obige ist der detaillierte Inhalt vonMehrere wissenswerte Frontend-Formatierungstools im Jahr 2023 [Zusammenfassung]. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!