19:I[15621,["/_next/static/immutable/chunks/3gm-8e62xn1qd.js","/_next/static/immutable/chunks/0n2yq6f-f75k2.js"],"ArticleReader"] 1a:Tcad,

// eslint.config.js
import js from '@eslint/js'
import imports from 'eslint-plugin-import'
import perfectionist from 'eslint-plugin-perfectionist'
import unicorn from 'eslint-plugin-unicorn'
import unusedImports from 'eslint-plugin-unused-imports'
import globals from 'globals'
import tseslint from 'typescript-eslint'

export default [
  // 1. 基础 + TS 专用 parser
  { files: ['**/*.{js,ts,mjs,cjs}'] },
  {
    languageOptions: {
      globals: { ...globals.node },
      parserOptions: {
        project: true, // 开启 project 模式，能检查类型（神器）
        tsconfigRootDir: import.meta.dirname,
      },
    },
  },

  // 2. 官方 + TS 官方推荐规则（必须最先）
  js.configs.recommended,
  ...tseslint.configs.recommended, // 基础 TS 检查
  ...tseslint.configs.recommendedTypeChecked, // 开启类型检查（强烈推荐）
  ...tseslint.configs.stylisticTypeChecked, // 可选：TS 风格建议

  // 3. unicorn（大部分规则对 TS 也适用）
  unicorn.configs['recommended'],

  // 4. import 插件（支持 .ts/.tsx 路径解析）
  {
    plugins: { import: imports },
    rules: {
      ...imports.configs.recommended.rules,
      'import/order': 'off', // 我们用 perfectionist 排序，关闭内置
    },
    settings: {
      'import/resolver': {
        typescript: {}, // eslint-import-resolver-typescript在这里调用 自动读取 tsconfig.json 的 paths、baseUrl
        node: true, // 同时保留 node 解析（防止 .json、.node 等文件报错）
      },
    },
  },

  // 6. perfectionist（完美支持 TS）
  {
    plugins: { perfectionist },
    rules: {
      'perfectionist/sort-imports': [
        'warn',
        {
          groups: [
            // type import 自动放最上面
            'type',
            ['builtin', 'external'],
            'internal',
            'parent',
            'sibling',
            'index',
            'object',
            'unknown',
          ],
        },
      ],
      'perfectionist/sort-exports': 'warn',
    },
  },

  // 7. unused-imports（TS 下表现更好）
  {
    plugins: { 'unused-imports': unusedImports },
    rules: {
      'unused-imports/no-unused-imports': 'error',
      // @typescript-eslint/no-unused-vars 会被自动关闭
    },
  },

  // 8. 个人最常用的微调（可以直接复制）
  {
    rules: {
      // 关闭与 @typescript-eslint 重叠的原生规则
      'no-unused-vars': 'off',
      'no-undef': 'off',

      // 后端常见放宽
      'no-console': 'off', // 方便调试
      'no-underscore-dangle': 'off', // 允许下划线命名 如 __dirname

      // TS 项目常见放宽
      '@typescript-eslint/no-explicit-any': 'warn', // 禁止使用 any 类型, 不是 off，只是 warn
      '@typescript-eslint/no-non-null-assertion': 'warn', // 禁止使用 ! 非空断言操作符
      '@typescript-eslint/no-empty-object-type': 'off', // 禁止空对象类型定义,关闭 interface {} 很常用
      '@typescript-eslint/consistent-type-imports': [
        // 强制 type import（推荐）强制 import { type User } from './types'
        'error',
        { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
      ],
    },
  },
]

1b:Tac2,// eslint.config.js import js from '@eslint/js' import imports from 'eslint-plugin-import' import perfectionist from 'eslint-plugin-perfectionist' import unicorn from 'eslint-plugin-unicorn' import unusedImports from 'eslint-plugin-unused-imports' import globals from 'globals' import tseslint from 'typescript-eslint' export default [ // 1. 基础 + TS 专用 parser { files: ['**/*.{js,ts,mjs,cjs}'] }, { languageOptions: { globals: { ...globals.node }, parserOptions: { project: true, // 开启 project 模式，能检查类型（神器） tsconfigRootDir: import.meta.dirname, }, }, }, // 2. 官方 + TS 官方推荐规则（必须最先） js.configs.recommended, ...tseslint.configs.recommended, // 基础 TS 检查 ...tseslint.configs.recommendedTypeChecked, // 开启类型检查（强烈推荐） ...tseslint.configs.stylisticTypeChecked, // 可选：TS 风格建议 // 3. unicorn（大部分规则对 TS 也适用） unicorn.configs['recommended'], // 4. import 插件（支持 .ts/.tsx 路径解析） { plugins: { import: imports }, rules: { ...imports.configs.recommended.rules, 'import/order': 'off', // 我们用 perfectionist 排序，关闭内置 }, settings: { 'import/resolver': { typescript: {}, // eslint-import-resolver-typescript在这里调用自动读取 tsconfig.json 的 paths、baseUrl node: true, // 同时保留 node 解析（防止 .json、.node 等文件报错） }, }, }, // 6. perfectionist（完美支持 TS） { plugins: { perfectionist }, rules: { 'perfectionist/sort-imports': [ 'warn', { groups: [ // type import 自动放最上面 'type', ['builtin', 'external'], 'internal', 'parent', 'sibling', 'index', 'object', 'unknown', ], }, ], 'perfectionist/sort-exports': 'warn', }, }, // 7. unused-imports（TS 下表现更好） { plugins: { 'unused-imports': unusedImports }, rules: { 'unused-imports/no-unused-imports': 'error', // @typescript-eslint/no-unused-vars 会被自动关闭 }, }, // 8. 个人最常用的微调（可以直接复制） { rules: { // 关闭与 @typescript-eslint 重叠的原生规则 'no-unused-vars': 'off', 'no-undef': 'off', // 后端常见放宽 'no-console': 'off', // 方便调试 'no-underscore-dangle': 'off', // 允许下划线命名如 __dirname // TS 项目常见放宽 '@typescript-eslint/no-explicit-any': 'warn', // 禁止使用 any 类型, 不是 off，只是 warn '@typescript-eslint/no-non-null-assertion': 'warn', // 禁止使用 ! 非空断言操作符 '@typescript-eslint/no-empty-object-type': 'off', // 禁止空对象类型定义,关闭 interface {} 很常用 '@typescript-eslint/consistent-type-imports': [ // 强制 type import（推荐）强制 import { type User } from './types' 'error', { prefer: 'type-imports', fixStyle: 'inline-type-imports' }, ], }, }, ]11:["$","main",null,{"className":"reader-page","children":[["$","div",null,{"className":"reader-kicker","children":[["$","$L10",null,{"href":"/sources/76354eeeea30da83","children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":16,"height":16,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-arrow-left","children":[["$","path","1l729n",{"d":"m12 19-7-7 7-7"}],["$","path","x3x0zl",{"d":"M19 12H5"}],"$undefined"]}]," 返回 ","冰冻大西瓜"]}],["$","span",null,{"children":"工程"}]]}],["$","header",null,{"className":"article-meta","children":[["$","span",null,{"children":["FROM · ","冰冻大西瓜"]}],["$","div",null,{"children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":15,"height":15,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-calendar-days","children":[["$","path","1cmpym",{"d":"M8 2v4"}],["$","path","4m81vk",{"d":"M16 2v4"}],["$","rect","1hopcy",{"width":"18","height":"18","x":"3","y":"4","rx":"2"}],["$","path","8toen8",{"d":"M3 10h18"}],["$","path","6423bh",{"d":"M8 14h.01"}],["$","path","1etili",{"d":"M12 14h.01"}],["$","path","1gbofw",{"d":"M16 14h.01"}],["$","path","lrp35t",{"d":"M8 18h.01"}],["$","path","mhygvu",{"d":"M12 18h.01"}],["$","path","kzsmim",{"d":"M16 18h.01"}],"$undefined"]}]," ","2026年7月31日",null]}]]}],["$","$L19",null,{"article":{"title":"TS ESLint 配置指南","byline":null,"publishedAt":"2026-07-31T13:10:51.000Z","language":"fr","blocks":[{"id":"b0","type":"paragraph","html":"

JS项目配置指南: https://linux.do/t/topic/1183320

","text":"JS项目配置指南: https://linux.do/t/topic/1183320"},{"id":"b1","type":"paragraph","html":"

TIP

","text":"TIP"},{"id":"b2","type":"paragraph","html":"

文档适用于Typescript版本>=5.0以上,最好是最新版

","text":"文档适用于Typescript版本>=5.0以上,最好是最新版"},{"id":"b3","type":"heading","html":"

现代插件介绍

","text":"现代插件介绍 "},{"id":"b4","type":"paragraph","html":"

JS项目中的包都支持TS:

","text":"JS项目中的包都支持TS:"},{"id":"b5","type":"heading","html":"

安装

","text":"安装 "},{"id":"b6","type":"paragraph","html":"

shell

","text":"shell"},{"id":"b7","type":"paragraph","html":"

pnpm add -D eslint-plugin-unused-imports eslint-plugin-import eslint-plugin-unicorn eslint-plugin-perfectionist @eslint/js typescript @types/node  eslint-import-resolver-typescript typescript-eslint globals

","text":"pnpm add -D eslint-plugin-unused-imports eslint-plugin-import eslint-plugin-unicorn eslint-plugin-perfectionist @eslint/js typescript @types/node eslint-import-resolver-typescript typescript-eslint globals"},{"id":"b8","type":"paragraph","html":"

WARNING

","text":"WARNING"},{"id":"b9","type":"paragraph","html":"

如果你的项目是 monorepo 项目, 安装库不要忘记 -w 也就是 pnpm add -Dw

","text":"如果你的项目是 monorepo 项目, 安装库不要忘记 -w 也就是 pnpm add -Dw"},{"id":"b10","type":"paragraph","html":"

我知晓还有部分有关风格指南的 lint 规则,

","text":"我知晓还有部分有关风格指南的 lint 规则,"},{"id":"b11","type":"paragraph","html":"

这些库我想不应该出现在通用文档指南中,如果需要可以自行在项目中添加,

","text":"这些库我想不应该出现在通用文档指南中,如果需要可以自行在项目中添加,"},{"id":"b12","type":"paragraph","html":"

说实话,看到要安装这么多的包, 我已经感觉蛮臃肿的了,

","text":"说实话,看到要安装这么多的包, 我已经感觉蛮臃肿的了,"},{"id":"b13","type":"paragraph","html":"

好在都是装在开发依赖中,不会对实际项目体积产生影响 😂

","text":"好在都是装在开发依赖中,不会对实际项目体积产生影响 😂"},{"id":"b14","type":"paragraph","html":"

[details=\"为什么还有 @eslint/js 包安装在ts项目中?\"] $\"2.webp\"$ [/details]

","text":"[details=\"为什么还有 @eslint/js 包安装在ts项目中?\"] [/details]"},{"id":"b15","type":"paragraph","html":"

同时需要安装插件 Eslint 点我安装 $\"\"$

","text":"同时需要安装插件 Eslint 点我安装"},{"id":"b16","type":"heading","html":"

配置

","text":"配置 "},{"id":"b17","type":"paragraph","html":"

","text":"js"},{"id":"b18","type":"paragraph","html":"$1a","text":"$1b"},{"id":"b19","type":"paragraph","html":"

大家可能留意到我并未导入eslint-import-resolver-typescript这个库,

","text":"大家可能留意到我并未导入eslint-import-resolver-typescript这个库,"},{"id":"b20","type":"paragraph","html":"

但又在package.json中安装了这个库

","text":"但又在package.json中安装了这个库"},{"id":"b21","type":"paragraph","html":"

原因是这个包是由其他依赖包自动调用的, 配置项中也做了额外注释

","text":"原因是这个包是由其他依赖包自动调用的, 配置项中也做了额外注释"},{"id":"b22","type":"paragraph","html":"

","text":"js"},{"id":"b23","type":"paragraph","html":"

    settings: {\n      'import/resolver': {\n        typescript: {}, // eslint-import-resolver-typescript在这里调用 自动读取 tsconfig.json 的 paths、baseUrl\n        node: true,     // 同时保留 node 解析（防止 .json、.node 等文件报错）\n      },

","text":"settings: { 'import/resolver': { typescript: {}, // eslint-import-resolver-typescript在这里调用自动读取 tsconfig.json 的 paths、baseUrl node: true, // 同时保留 node 解析（防止 .json、.node 等文件报错） },"},{"id":"b24","type":"heading","html":"

插件周下载量(2025年11月19日)

","text":"插件周下载量(2025年11月19日) "},{"id":"b25","type":"list","html":"

","text":"eslint-plugin-unused-imports: 4,967,752eslint-plugin-import: 32,590,009eslint-plugin-unicorn: 4,752,987eslint-plugin-promise: 5,303,551eslint-plugin-perfectionist: 1,169,778@eslint/js: 55,530,414"},{"id":"b26","type":"list","html":"

typescript-eslint: 15,320,324
@types/node: 145,730,231
globals:115,151,028

","text":"typescript-eslint: 15,320,324@types/node: 145,730,231globals:115,151,028"},{"id":"b27","type":"paragraph","html":"

TIP

","text":"TIP"},{"id":"b28","type":"paragraph","html":"

这里只是列举了通用插件, 如果有使用到第三方库如 express, react, jest lodash, mongodb等等,需自行安装额外的ts支持库.

","text":"这里只是列举了通用插件, 如果有使用到第三方库如 express, react, jest lodash, mongodb等等,需自行安装额外的ts支持库."},{"id":"b29","type":"heading","html":"

更新内容

","text":"更新内容 "},{"id":"b30","type":"heading","html":"

2025年12月6日

","text":"2025年12月6日 "},{"id":"b31","type":"list","html":"

移除了eslint-plugin-promise规则,并且移除了相关配置项,因为不支持ts声明,后续是否补回待定(佬友有建设性观点可以发布在评论区)
添加了globals库, 提供预定义的全局变量集合，用于 ESLint 配置中声明不同环境下的全局变量。
更新了安装脚本:移除eslint-plugin-promise,@typescript-eslint/eslint-plugin 和 @typescript-eslint/parser,添加globals

","text":"移除了eslint-plugin-promise规则,并且移除了相关配置项,因为不支持ts声明,后续是否补回待定(佬友有建设性观点可以发布在评论区)添加了globals库, 提供预定义的全局变量集合，用于 ESLint 配置中声明不同环境下的全局变量。更新了安装脚本:移除eslint-plugin-promise,@typescript-eslint/eslint-plugin 和 @typescript-eslint/parser,添加globals"},{"id":"b32","type":"heading","html":"

2025年11月19日

","text":"2025年11月19日 "},{"id":"b33","type":"paragraph","html":"

替换 @typescript-eslint/eslint-plugin 和 @typescript-eslint/parser 为 typescript-eslint ts官方已将2个包合并为一个包,降低配置负担和心智负担

","text":"替换 @typescript-eslint/eslint-plugin 和 @typescript-eslint/parser 为 typescript-eslint ts官方已将2个包合并为一个包,降低配置负担和心智负担"}],"source":"$0:f:0:1:0:props:children:props:children:1:props:children:props:children:props:children:0:props:sources:457","originalUrl":"https://bddxg.top/Tips/EslintTs.html","excerpt":"TypeScript 项目 ESLint 完整配置指南，包含类型检查、路径解析等现代化规则"},"shouldTranslate":true}],"$L1c"]}]

现代插件介绍 ​

安装 ​

配置 ​

插件周下载量(2025年11月19日) ​

更新内容 ​

2025年12月6日 ​

2025年11月19日 ​

现代插件介绍

安装

配置

插件周下载量(2025年11月19日)

更新内容

2025年12月6日

2025年11月19日