1
export default [
2
  // 配置对象 1：全局设置
3
  {
4
    languageOptions: {
5
      ecmaVersion: 2024,
6
      sourceType: 'module',
7
    },
8
  },
9

10
  // 配置对象 2：只对 TypeScript 文件生效
11
  {
12
    files: ['**/*.ts', '**/*.tsx'],
13
    rules: {
14
      'no-undef': 'off', // TypeScript 处理这个
15
    },
16
  },
17

18
  // 配置对象 3：忽略文件
19
  {
20
    ignores: ['dist/', 'node_modules/', '*.min.js'],
21
  },
22
];

1
{
2
  "root": true,
3
  "env": {
4
    "browser": true,
5
    "es2024": true,
6
    "node": true
7
  },
8
  "extends": [
9
    "eslint:recommended",
10
    "plugin:@typescript-eslint/recommended",
11
    "plugin:vue/vue3-recommended",
12
    "prettier"
13
  ],
14
  "parser": "vue-eslint-parser",
15
  "parserOptions": {
16
    "parser": "@typescript-eslint/parser",
17
    "ecmaVersion": "latest",
18
    "sourceType": "module"
19
  },
20
  "plugins": ["@typescript-eslint"],
21
  "rules": {
22
    "no-console": "warn",
23
    "no-debugger": "error",
24
    "@typescript-eslint/no-explicit-any": "warn",
25
    "@typescript-eslint/no-unused-vars": ["error", {
26
      "argsIgnorePattern": "^_"
27
    }],
28
    "vue/multi-word-component-names": "off",
29
    "vue/no-v-html": "off"
30
  },
31
  "overrides": [
32
    {
33
      "files": ["*.test.ts", "*.spec.ts"],
34
      "env": {
35
        "jest": true
36
      },
37
      "rules": {
38
        "no-console": "off"
39
      }
40
    }
41
  ]
42
}

1
import globals from 'globals';
2
import tseslint from 'typescript-eslint';
3
import pluginVue from 'eslint-plugin-vue';
4
import eslintConfigPrettier from 'eslint-config-prettier';
5

6
export default tseslint.config(
7
  // 全局忽略
8
  {
9
    ignores: [
10
      'dist/**',
11
      'node_modules/**',
12
      'coverage/**',
13
      '*.d.ts',
14
    ],
15
  },
16

17
  // 基础配置
18
  {
19
    languageOptions: {
20
      ecmaVersion: 2024,
21
      sourceType: 'module',
22
      globals: {
23
        ...globals.browser,
24
        ...globals.es2024,
25
        ...globals.node,
26
      },
27
    },
28
  },
29

30
  // ESLint 推荐规则
31
  // eslint v9+ 导出为 flat config
32
  {
33
    rules: {
34
      // eslint:recommended 规则已内置在 tseslint.configs.recommended 中
35
    },
36
  },
37

38
  // TypeScript 推荐规则
39
  ...tseslint.configs.recommended,
40

41
  // Vue 推荐规则
42
  ...pluginVue.configs['flat/recommended'],
43

44
  // Vue 文件的解析器配置
45
  {
46
    files: ['**/*.vue'],
47
    languageOptions: {
48
      parserOptions: {
49
        parser: tseslint.parser,
50
      },
51
    },
52
  },
53

54
  // 自定义规则
55
  {
56
    rules: {
57
      'no-console': 'warn',
58
      'no-debugger': 'error',
59
      '@typescript-eslint/no-explicit-any': 'warn',
60
      '@typescript-eslint/no-unused-vars': ['error', {
61
        argsIgnorePattern: '^_',
62
        varsIgnorePattern: '^_',
63
      }],
64
      'vue/multi-word-component-names': 'off',
65
      'vue/no-v-html': 'off',
66
    },
67
  },
68

69
  // 测试文件
70
  {
71
    files: ['**/*.test.ts', '**/*.spec.ts', 'tests/**'],
72
    languageOptions: {
73
      globals: {
74
        ...globals.jest,
75
      },
76
    },
77
    rules: {
78
      'no-console': 'off',
79
      '@typescript-eslint/no-explicit-any': 'off',
80
    },
81
  },
82

83
  // Prettier 兼容（必须放最后）
84
  eslintConfigPrettier,
85
);

1
const noFooBarRule = {
2
  meta: {
3
    type: 'suggestion',
4
    docs: {
5
      description: 'Disallow variable names "foo" and "bar"',
6
    },
7
    fixable: 'code',
8
    schema: [],
9
    messages: {
10
      noFooBar: 'Variable name "{{name}}" is not allowed. Use meaningful names.',
11
    },
12
  },
13
  create(context) {
14
    return {
15
      VariableDeclarator(node) {
16
        if (
17
          node.id.type === 'Identifier' &&
18
          ['foo', 'bar', 'baz'].includes(node.id.name)
19
        ) {
20
          context.report({
21
            node: node.id,
22
            messageId: 'noFooBar',
23
            data: { name: node.id.name },
24
          });
25
        }
26
      },
27
    };
28
  },
29
};
30

31
export default [
32
  {
33
    plugins: {
34
      custom: {
35
        rules: {
36
          'no-foo-bar': noFooBarRule,
37
        },
38
      },
39
    },
40
    rules: {
41
      'custom/no-foo-bar': 'error',
42
    },
43
  },
44
];

1
import noMagicNumbers from './rules/no-magic-numbers.js';
2
import requireJsdoc from './rules/require-jsdoc.js';
3
import noTodoWithoutIssue from './rules/no-todo-without-issue.js';
4

5
const plugin = {
6
  meta: {
7
    name: 'eslint-plugin-my-team',
8
    version: '1.0.0',
9
  },
10
  rules: {
11
    'no-magic-numbers': noMagicNumbers,
12
    'require-jsdoc': requireJsdoc,
13
    'no-todo-without-issue': noTodoWithoutIssue,
14
  },
15
  configs: {},
16
};
17

18
// 自引用配置（Flat Config 风格）
19
plugin.configs.recommended = [
20
  {
21
    plugins: {
22
      'my-team': plugin,
23
    },
24
    rules: {
25
      'my-team/no-magic-numbers': 'warn',
26
      'my-team/no-todo-without-issue': 'error',
27
    },
28
  },
29
];
30

31
export default plugin;

1
export default {
2
  meta: {
3
    type: 'suggestion',
4
    docs: {
5
      description: 'Require TODO comments to include an issue link',
6
    },
7
    schema: [{
8
      type: 'object',
9
      properties: {
10
        pattern: { type: 'string' },
11
      },
12
      additionalProperties: false,
13
    }],
14
    messages: {
15
      missingIssue: 'TODO comment must include an issue link (e.g., TODO(#123))',
16
    },
17
  },
18
  create(context) {
19
    const pattern = context.options[0]?.pattern || '#\\d+';
20
    const issueRegex = new RegExp(pattern);
21

22
    return {
23
      Program() {
24
        const comments = context.sourceCode.getAllComments();
25
        for (const comment of comments) {
26
          const value = comment.value.trim();
27
          if (/\bTODO\b/i.test(value) && !issueRegex.test(value)) {
28
            context.report({
29
              node: comment,
30
              messageId: 'missingIssue',
31
            });
32
          }
33
        }
34
      },
35
    };
36
  },
37
};

1
import globals from 'globals';
2
import tseslint from 'typescript-eslint';
3
import pluginVue from 'eslint-plugin-vue';
4
import eslintConfigPrettier from 'eslint-config-prettier';
5

6
export function createConfig(options = {}) {
7
  const {
8
    vue = false,
9
    typescript = true,
10
    prettier = true,
11
    testFramework = 'vitest',
12
  } = options;
13

14
  const configs = [
15
    // 全局忽略
16
    {
17
      ignores: ['dist/**', 'node_modules/**', 'coverage/**'],
18
    },
19
    // 基础
20
    {
21
      languageOptions: {
22
        ecmaVersion: 2024,
23
        sourceType: 'module',
24
        globals: {
25
          ...globals.browser,
26
          ...globals.node,
27
        },
28
      },
29
    },
30
  ];
31

32
  // TypeScript
33
  if (typescript) {
34
    configs.push(...tseslint.configs.recommended);
35
  }
36

37
  // Vue
38
  if (vue) {
39
    configs.push(
40
      ...pluginVue.configs['flat/recommended'],
41
      {
42
        files: ['**/*.vue'],
43
        languageOptions: {
44
          parserOptions: {
45
            parser: tseslint.parser,
46
          },
47
        },
48
      },
49
    );
50
  }
51

52
  // 测试文件
53
  const testGlobals = testFramework === 'vitest'
54
    ? { describe: 'readonly', it: 'readonly', expect: 'readonly', vi: 'readonly', beforeEach: 'readonly', afterEach: 'readonly' }
55
    : globals.jest;
56

57
  configs.push({
58
    files: ['**/*.test.*', '**/*.spec.*', 'tests/**'],
59
    languageOptions: { globals: testGlobals },
60
    rules: { 'no-console': 'off' },
61
  });
62

63
  // Prettier（必须最后）
64
  if (prettier) {
65
    configs.push(eslintConfigPrettier);
66
  }
67

68
  return configs;
69
}

1
import globals from 'globals';
2
import tseslint from 'typescript-eslint';
3

4
export const base = tseslint.config(
5
  ...tseslint.configs.recommended,
6
  {
7
    languageOptions: {
8
      ecmaVersion: 2024,
9
      globals: { ...globals.browser, ...globals.node },
10
    },
11
    rules: {
12
      '@typescript-eslint/no-unused-vars': ['error', {
13
        argsIgnorePattern: '^_',
14
      }],
15
    },
16
  },
17
);
18

19
// 各子包使用
20
// apps/web/eslint.config.js
21
import { base } from '@monorepo/eslint-config';
22

23
export default [
24
  ...base,
25
  {
26
    rules: {
27
      // 项目特定规则
28
    },
29
  },
30
];