框架
版本

ESLint 插件 Router

TanStack Router 自带 ESLint 插件。此插件用于强制执行最佳实践,并帮助您避免常见错误。

安装

该插件是一个独立的包,您需要安装它

sh
npm install -D @tanstack/eslint-plugin-router
npm install -D @tanstack/eslint-plugin-router

sh
pnpm add -D @tanstack/eslint-plugin-router
pnpm add -D @tanstack/eslint-plugin-router

sh
yarn add -D @tanstack/eslint-plugin-router
yarn add -D @tanstack/eslint-plugin-router

sh
bun add -D @tanstack/eslint-plugin-router
bun add -D @tanstack/eslint-plugin-router

扁平配置 (eslint.config.js)

ESLint 9.0 的发布引入了一种使用扁平配置格式配置 ESLint 的新方法。这种新格式更加灵活,允许您以比传统 .eslintrc 格式更精细的方式配置 ESLint。TanStack Router ESLint 插件支持这种新格式,并提供了一个推荐配置,您可以使用它来启用插件的所有推荐规则。

要启用我们插件的所有推荐规则,请添加以下配置

js
// eslint.config.js
import pluginRouter from '@tanstack/eslint-plugin-router'

export default [
  ...pluginRouter.configs['flat/recommended'],
  // Any other config...
]
// eslint.config.js
import pluginRouter from '@tanstack/eslint-plugin-router'

export default [
  ...pluginRouter.configs['flat/recommended'],
  // Any other config...
]

自定义扁平配置设置

或者,您可以加载插件并仅配置您想要使用的规则

js
// eslint.config.js
import pluginRouter from '@tanstack/eslint-plugin-router'

export default [
  {
    plugins: {
      '@tanstack/router': pluginRouter,
    },
    rules: {
      '@tanstack/router/create-route-property-order': 'error',
    },
  },
  // Any other config...
]
// eslint.config.js
import pluginRouter from '@tanstack/eslint-plugin-router'

export default [
  {
    plugins: {
      '@tanstack/router': pluginRouter,
    },
    rules: {
      '@tanstack/router/create-route-property-order': 'error',
    },
  },
  // Any other config...
]

传统配置 (.eslintrc)

在 ESLint 9.0 发布之前,配置 EsLint 最常见的方法是使用 .eslintrc 文件。TanStack Router ESLint 插件仍然支持此配置方法。

要启用我们插件的所有推荐规则,请在 extends 中添加 plugin:@tanstack/eslint-plugin-router/recommended

json
{
  "extends": ["plugin:@tanstack/eslint-plugin-router/recommended"]
}
{
  "extends": ["plugin:@tanstack/eslint-plugin-router/recommended"]
}

自定义传统配置设置

或者,将 @tanstack/eslint-plugin-router 添加到 plugins 部分,并配置您想要使用的规则

json
{
  "plugins": ["@tanstack/eslint-plugin-router"],
  "rules": {
    "@tanstack/router/create-route-property-order": "error"
  }
}
{
  "plugins": ["@tanstack/eslint-plugin-router"],
  "rules": {
    "@tanstack/router/create-route-property-order": "error"
  }
}

规则

以下规则在 TanStack Router ESLint 插件中可用

订阅 Bytes

您的每周 JavaScript 新闻。每周一免费发送给超过 100,000 名开发者。

Bytes

没有垃圾邮件。随时取消订阅。