199 lines
14 KiB
JavaScript
199 lines
14 KiB
JavaScript
{
|
||
"extends": [
|
||
// 这一行告诉ESLint去使用@typescript-eslint/recommended规则集。这个规则集包含了TypeScript团队推荐的一系列规则，有助于识别TypeScript代码中的常见问题，比如语法错误、潜在的类型问题等。
|
||
"plugin:@typescript-eslint/recommended",
|
||
// 这行配置引入了Vue 3的官方ESLint插件推荐的规则集。它包含了对于Vue 3单文件组件(SFCs)的最佳实践建议，帮助开发者遵循Vue的编码规范，包括模板、脚本和样式部分的检查
|
||
"plugin:vue/vue3-recommended",
|
||
// 此行配置启用了Prettier的ESLint插件，并使用其推荐的规则。Prettier是一个流行的代码格式化工具，能够自动格式化代码以保持一致的风格。通过此配置，你的代码风格将与Prettier的标准保持一致，减少因格式差异导致的代码审查冲突。
|
||
"plugin:prettier/recommended"
|
||
],
|
||
"env": {
|
||
// 告诉ESLint你的代码将在浏览器环境中运行。因此，ESLint会启用或强化那些与浏览器环境相关的规则，比如禁止使用Node.js特有的全局变量(如require)。
|
||
"browser": true,
|
||
// 表明你的代码设计为在Node.js环境中执行。启用这个选项后，ESLint会认识Node.js的全局变量和Node.js特有的API调用，避免这些被误报为错误。
|
||
"node": true,
|
||
// 指出你的项目使用Jest作为测试框架。这会配置ESLint以理解Jest的全局变量和函数，确保在编写测试代码时不会因为使用了Jest的特性而触发不必要的警告或错误。
|
||
"jest": true,
|
||
// 指示你的代码基于ECMAScript 6(ES6，也称作ES2015)或更高版本的标准。启用此选项后，ESLint会支持ES6的语法特性，并根据这些新标准调整相关规则，比如允许使用箭头函数、解构赋值等ES6特性。
|
||
"es6": true
|
||
},
|
||
"plugins": [
|
||
// 这个插件使得ESLint能够理解并检查Vue.js单文件组件(SFCs)中的代码。它提供了对Vue模板语法、script部分以及style部分的 linting 规则，帮助开发者遵循Vue的最佳实践，提升代码质量和可维护性
|
||
"vue",
|
||
// 插件是专门为TypeScript设计的，它允许ESLint理解和 lint TypeScript 代码。这个插件集成了许多有用的规则，用以识别TypeScript特有的一些潜在问题，比如类型错误提示、不必要的类型断言等，从而提高TypeScript代码的质量和类型安全性。
|
||
"@typescript-eslint"
|
||
],
|
||
"globals": {
|
||
// 这两个全局变量通常与Cypress测试框架相关，cy是Cypress提供的命令链方法的主入口点，用于编写测试代码；Cypress则是该框架的全局对象，包含配置和其他功能。标记为readonly表示这些变量不应在代码中被重新赋值，仅用于读取和调用。
|
||
"cy": "readonly",
|
||
"Cypress": "readonly",
|
||
// 表示clipboardData是一个预期存在的全局变量，可能与浏览器的剪贴板操作有关，标记为只读意味着它不应该被修改
|
||
"clipboardData": "readonly",
|
||
// 定义了一个名为PKG_VERSION的全局变量，这里的true表示这是一个可写的全局变量，没有特别限制其使用方式。这种变量可能用于存储项目版本信息等。
|
||
"PKG_VERSION": true,
|
||
// 这两个全局变量与Vue 3的Composition API紧密相关。defineProps用于定义组件接收的props，而defineEmits用于定义组件可以发出的事件。它们都被标记为只读，意味着这些函数不应该被赋予新的值，仅用于组件内部的属性和事件声明
|
||
"defineProps": "readonly",
|
||
"defineEmits": "readonly"
|
||
},
|
||
"parserOptions": {
|
||
// 指定了ESLint应该使用@typescript-eslint/parser作为代码解析器。这个解析器是专门为TypeScript设计的，能够理解TypeScript的语法特性，使得ESLint能够正确地解析和 lint TypeScript 代码。
|
||
"parser": "@typescript-eslint/parser",
|
||
// 告诉ESLint你的代码使用的是ES模块(import/export语法)，而不是传统的CommonJS模块(如require)。这会影响如何解析模块导入导出语句
|
||
"sourceType": "module",
|
||
// 允许在代码的任何位置使用import和export语句，而不局限于模块顶层。这在某些特定的项目配置或使用场景下可能有用，但通常建议仅在模块顶层使用导入导出以遵循最佳实践。
|
||
"allowImportExportEverywhere": true,
|
||
// 启用对JSX的支持。这意味着ESLint会正确解析包含JSX元素(一种HTML-like语法，常用于React和其他库中编写用户界面)的代码，不会将其视为错误。当你的项目中包含前端组件并使用JSX编写时，这一设置是必要的。
|
||
"ecmaFeatures": {
|
||
"jsx": true
|
||
}
|
||
},
|
||
"settings": {
|
||
// 这个设置指定了ESLint在检查导入语句时应考虑的文件扩展名列表。列表中的每一个扩展名都代表了一种ESLint会认为是有效导入目标的文件类型。
|
||
"import/extensions": [
|
||
".js",
|
||
".jsx",
|
||
".ts",
|
||
".tsx"
|
||
]
|
||
},
|
||
// 这段配置详细地定义了ESLint的规则设置，覆盖了代码风格、导入管理、以及TypeScript和Vue特定的规则。以下是一些关键规则及其含义的简要说明：
|
||
// 通用代码风格规则
|
||
// "no-console": ["error", { "allow": ["info", "warn", "error"] }]: 错误级别地禁止使用console.log等方法，但允许console.info、console.warn和console.error。
|
||
// "no-continue": "off", "no-restricted-syntax": "off", "no-plusplus": "off" 等: 这些规则被关闭，意味着允许使用continue语句、不限制特定语法结构(如for循环)、允许自增自减操作符等。
|
||
// "no-param-reassign": "off", "no-shadow": "off": 关闭参数重赋值和变量阴影的检查。
|
||
// "no-underscore-dangle": ["error"]: 错误级别地禁止在标识符中使用前导或尾随下划线(某些例外可能通过其他配置允许)。
|
||
// 未使用变量和表达式
|
||
// "no-unused-vars": "off", "no-unused-expressions": "off": 关闭未使用变量和未使用的表达式的检查。
|
||
// 函数和循环
|
||
// "func-names": "off", "guard-for-in": "off", "consistent-return": "off": 不强制函数命名规则、不检查for...in循环的安全性、不强制函数返回一致性。
|
||
// 导入规则
|
||
// "import/extensions": "off", "import/no-unresolved": "off", "import/no-extraneous-dependencies": "off": 关闭导入文件扩展名检查、未解决的导入路径检查、以及禁止导入非直接依赖。
|
||
// "import/prefer-default-export": "off": 不强制模块使用默认导出。
|
||
// TypeScript规则
|
||
// @typescript-eslint: 大多数TypeScript相关的规则被关闭或放宽，如允许any类型、不强制模块边界类型、允许require导入、允许空函数、允许特定类型注释等。但也有配置，如"@typescript-eslint/no-unused-vars"，设置为警告级别，并指定了忽略模式以忽略以_开头的变量。
|
||
// Vue规则
|
||
// "vue/require-default-prop", "vue/multi-word-component-names", "vue/no-deprecated-slot-attribute": 这些Vue规则被关闭，意味着组件不必提供默认prop、组件名称不必多词、允许使用已废弃的slot属性。
|
||
// 整体来看，这些规则配置放松了很多常见的代码风格和最佳实践检查，可能旨在提高开发速度或适应特定团队的编码习惯。然而，过度放宽规则可能牺牲代码质量和可维护性，因此建议根据项目实际需要仔细权衡。
|
||
"rules": {
|
||
"no-console": [
|
||
"error",
|
||
{
|
||
"allow": ["info", "warn", "error"]
|
||
}
|
||
],
|
||
// code style config
|
||
"no-continue": "off",
|
||
"no-restricted-syntax": "off",
|
||
"no-plusplus": "off",
|
||
"no-param-reassign": "off",
|
||
"no-shadow": "off",
|
||
"no-underscore-dangle": ["error"],
|
||
"no-unused-vars": "off",
|
||
"no-unused-expressions": "off",
|
||
"no-return-assign": "off",
|
||
"no-use-before-define": "off",
|
||
"func-names": "off",
|
||
"guard-for-in": "off",
|
||
"consistent-return": "off",
|
||
"no-restricted-globals": "off",
|
||
"default-param-last": "off",
|
||
"default-case": "off",
|
||
"prefer-spread": "off",
|
||
|
||
// import config
|
||
"import/extensions": "off",
|
||
"import/no-unresolved": "off",
|
||
"import/no-extraneous-dependencies": "off",
|
||
"import/prefer-default-export": "off",
|
||
"import/no-relative-packages": "off",
|
||
|
||
// typescript config
|
||
"@typescript-eslint/no-explicit-any": "off",
|
||
"@typescript-eslint/explicit-module-boundary-types": "off",
|
||
"@typescript-eslint/no-require-imports": 0,
|
||
"@typescript-eslint/no-var-requires": 0,
|
||
"@typescript-eslint/prefer-for-of": 0,
|
||
"@typescript-eslint/ban-types": 0,
|
||
"@typescript-eslint/no-unused-vars": [
|
||
1,
|
||
{
|
||
"argsIgnorePattern": "^_",
|
||
"varsIgnorePattern": "^_"
|
||
}
|
||
],
|
||
"@typescript-eslint/no-empty-function": 0,
|
||
"@typescript-eslint/ban-ts-comment": 0,
|
||
"vue/require-default-prop": 0,
|
||
"vue/multi-word-component-names": 0,
|
||
"vue/no-deprecated-slot-attribute": 0
|
||
},
|
||
"overrides": [
|
||
{
|
||
// "files": ["*.vue"]: 指定此override应用于所有扩展名为.vue的文件，即Vue单文件组件(SFCs)。 在rules部分，针对Vue组件设置了特定的规则：
|
||
"files": ["*.vue"],
|
||
// 此规则强制组件名称在模板中必须遵循“kebab-case”(短横线连接的小写单词，例如<my-component>)。数字2表示如果违反此规则，ESLint将以错误级别报告(最严格的级别，通常会导致构建失败或警告)。
|
||
"rules": {
|
||
"vue/component-name-in-template-casing": [2, "kebab-case"],
|
||
// 这个规则被设置为0，意味着完全关闭了对组件默认属性(props)的要求。Vue通常推荐为组件的props提供默认值，以增强组件的可复用性，但此处决定不强制执行此最佳实践。
|
||
"vue/require-default-prop": 0
|
||
}
|
||
},
|
||
{
|
||
// "files": 列出了覆盖规则将应用的文件路径模式。
|
||
"files": [
|
||
// **/_example/*: 匹配任何层级下以_example为目录名的文件。
|
||
"**/_example/*",
|
||
// **/_example - ts/*: 类似地，匹配任何层级下以_example - ts为目录名的
|
||
"**/_example - ts/*",
|
||
// script/**/* 和script/*: 匹配script目录下的所有文件，无论深度如何。
|
||
"script/**/* ",
|
||
"script/*",
|
||
// *.js: 匹配任何直接位于根目录下的.js文件。
|
||
"*.js",
|
||
// site/**/*和site/*: 匹配site目录下的所有文件，不论层级。
|
||
"site/**/*",
|
||
//
|
||
"site/*"
|
||
],
|
||
// "rules": 定义了在上述指定的文件范围内生效的特定规则。
|
||
"rules": {
|
||
// "no-var-requires": 0: 禁止使用require语句中的变量声明(var关键字)，但在这些文件中该规则被关闭。
|
||
"no-var-requires": 0,
|
||
// "no-console": 0: 允许使用console.log等console方法，不报错。
|
||
"no-console": 0,
|
||
// "no-unused-expressions": 0: 不检查未使用的表达式，如未赋值的函数调用。
|
||
"no-unused-expressions": 0,
|
||
// "no-alert": 0: 允许使用alert函数，不报错。
|
||
"no-alert": 0
|
||
}
|
||
},
|
||
{
|
||
// "files": 指定了覆盖规则适用的文件类型，这里是所有的TypeScript (*.ts) 和 TypeScript with JSX (*.tsx) 文件。
|
||
"files": [
|
||
"*.ts",
|
||
"*.tsx"
|
||
],
|
||
// "rules": 针对这些文件类型，配置了一个特定的TypeScript ESLint规则
|
||
"rules": {
|
||
// "@typescript-eslint/explicit-function-return-type": 0: 禁用了
|
||
"@typescript-eslint/explicit-function-return-type": 0
|
||
}
|
||
},
|
||
{
|
||
// "files": 指定了覆盖规则适用的文件模式，这里是所有以.test.js结尾的文件，即测试脚本文件。
|
||
"files": [
|
||
"*.test.js"
|
||
],
|
||
"rules": {
|
||
// "import/no-dynamic-require": "off": 关闭了import/no-dynamic-require规则。这条规则通常禁止在运行时动态地使用require()来导入模块，以鼓励静态分析和提前发现潜在的模块加载错误。但在测试环境中，动态加载模块可能是为了模拟或测试特定条件下的行为，因此在这个上下文中关闭该规则是有道理的
|
||
"import/no-dynamic-require": "off",
|
||
// "global-require": "off": 同样，关闭了global-require规则。这条规则通常建议避免在全局作用域使用require()，鼓励模块化的代码结构。然而，在测试文件中，有时直接在全局作用域使用require()来引入测试工具、模拟模块或设置测试环境是常见的做法，因此在此场景下关闭该规则可以减少不必要的警告。
|
||
"global-require": "off"
|
||
}
|
||
},
|
||
// 单独的"files": "*"}配置段在ESLint的overrides部分表示一个非常宽泛的覆盖规则，理论上意在应用于所有文件
|
||
{
|
||
"files": "*"
|
||
}
|
||
]
|
||
} |