在Visual Studio Code中无法让ESLint与Cypress正常配合工作

数据老陈

2026-6-23

ESLint v9 集成 Cypress 插件无提示问题排查与解决

问题情况

已安装依赖：

"eslint": "^9.4.0",
"eslint-plugin-cypress": "^3.3.0"

配置文件eslint.config.js内容：

module.exports = [
    {
        "plugins": [
          "cypress"
        ]
      },
      {
        "rules": {
          "cypress/no-assigning-return-values": "error",
          "cypress/no-unnecessary-waiting": "error",
          "cypress/assertion-before-screenshot": "warn",
          "cypress/no-force": "warn",
          "cypress/no-async-tests": "error",
          "cypress/no-async-before": "error",
          "cypress/no-pause": "error"
        }
      },
      {
        "env": {
          "cypress/globals": true
        }
      }
];

测试代码（cy.js）：

describe('test', () => {
  it('test', () => {
    cy.pause();
});
})

问题：运行ESLint检查时，cy.pause()没有触发cypress/no-pause的错误提示。

问题原因

ESLint v9采用了扁平配置系统，和旧版eslintrc的配置逻辑不一样，原配置存在两个关键问题：

插件没有正确导入：扁平配置里需要直接引入插件模块，不能只写插件名称
配置拆分过散：多个独立的配置对象可能没被正确合并生效

修复方案

把eslint.config.js改成下面的结构：

const cypress = require('eslint-plugin-cypress');

module.exports = [
  {
    // 指定规则生效的文件范围，确保Cypress测试文件被覆盖
    files: ['**/*.cy.js', '**/*.cy.ts'],
    plugins: {
      cypress: cypress,
    },
    env: {
      'cypress/globals': true,
    },
    rules: {
      'cypress/no-assigning-return-values': 'error',
      'cypress/no-unnecessary-waiting': 'error',
      'cypress/assertion-before-screenshot': 'warn',
      'cypress/no-force': 'warn',
      'cypress/no-async-tests': 'error',
      'cypress/no-async-before': 'error',
      'cypress/no-pause': 'error',
    },
  },
];