// @ts-check import js from '@eslint/js'; import tseslint from 'typescript-eslint'; import reactHooks from 'eslint-plugin-react-hooks'; import reactNative from 'eslint-plugin-react-native'; export default tseslint.config( // 全局忽略 { ignores: [ 'node_modules/**', 'android/**', 'ios/**', '.expo/**', 'reference_project/**', 'outputs/**', '*.js', // 根目录脚本(fix_*.js 等) 'plugins/**/android/**', ], }, // 基础推荐规则 js.configs.recommended, ...tseslint.configs.recommended, // 全局规则调整 { rules: { // RN 中原生模块加载常使用 require() '@typescript-eslint/no-require-imports': 'off', // 不强制要求 error cause 'preserve-caught-error': 'off', }, }, // React Hooks 规则 { plugins: { 'react-hooks': reactHooks, }, rules: { 'react-hooks/rules-of-hooks': 'error', 'react-hooks/exhaustive-deps': 'warn', // 以下规则对 RN 项目过于严格,暂时关闭 'react-hooks/purity': 'off', // Date.now() 在渲染中使用是常见模式 'react-hooks/immutability': 'off', // 修改外部变量(如 i18n.locale)是有意为之 'react-hooks/refs': 'off', // 访问 ref 值在 RN 中常见 'react-hooks/preserve-caught-error': 'off', // 不强制要求 cause }, }, // React Native 规则(仅对 src/ 下的 tsx/ts 文件) { files: ['src/**/*.{ts,tsx}'], plugins: { 'react-native': reactNative, }, rules: { 'react-native/no-unused-styles': 'warn', 'react-native/no-inline-styles': 'off', // 项目中存在合理的内联样式 'react-native/no-color-literals': 'off', // 使用主题 token,但允许少量直接颜色 'react-native/no-raw-text': 'off', // 不强制所有文本包裹 }, }, // 项目自定义规则 { files: ['src/**/*.{ts,tsx}'], rules: { // TypeScript 严格相关 '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_', varsIgnorePattern: '^_', }], '@typescript-eslint/no-explicit-any': 'warn', '@typescript-eslint/explicit-function-return-type': 'off', '@typescript-eslint/no-non-null-assertion': 'off', // RN 中原生模块加载常使用 require(),允许 '@typescript-eslint/no-require-imports': 'off', // 代码质量 'no-console': ['warn', { allow: ['warn', 'error'] }], 'prefer-const': 'error', 'no-var': 'error', eqeqeq: ['error', 'always', { null: 'ignore' }], // Domain 层纯净性:禁止引入 React/RN 'no-restricted-imports': ['error', { patterns: [{ group: ['react', 'react-native', 'expo-*'], message: 'Domain 层(src/domain/)不允许引入 React/RN/Expo 依赖。', }], }], }, }, // Domain 层豁免(domain 目录不需要 React 限制,但上面已全局限制) // 实际上 no-restricted-imports 对 domain 层生效即可 // 非 domain 层解除限制 { files: ['src/**/*.{ts,tsx}', '!src/domain/**'], rules: { 'no-restricted-imports': 'off', }, }, // 测试文件宽松规则 { files: ['tests/**/*.{ts,tsx}'], rules: { '@typescript-eslint/no-explicit-any': 'off', '@typescript-eslint/no-unused-vars': 'warn', // 测试中未使用变量降为警告 '@typescript-eslint/ban-ts-comment': 'off', // 测试中允许 @ts-ignore 'no-console': 'off', }, }, );