NextJS项目构建报错：home.cy.ts无法在--isolatedModules模式下编译

云上老周

2026-8-8

解决Cypress e2e文件的--isolatedModules编译错误

针对你遇到的'home.cy.ts' cannot be compiled under '--isolatedModules'错误，按以下步骤排查解决：

1. 给报错的测试文件添加模块标识

错误明确指向home.cy.ts，你之前给index.ts加export的操作不对，需要在**home.cy.ts文件的顶部或底部**添加空导出语句，把它从全局脚本转为模块：

// 在home.cy.ts最顶部或最底部添加
export {};

2. 修改Cypress专属的TypeScript配置

Cypress会优先读取自身目录下的tsconfig.json（通常在cypress/目录下），根目录的tsconfig.json设置不会覆盖它——这也是你改根目录isolatedModules: false没用的核心原因：

打开cypress/tsconfig.json，确保compilerOptions里的isolatedModules设为false：

{
  "compilerOptions": {
    "isolatedModules": false,
    "target": "ES2020",
    "module": "ESNext",
    // 其他原有配置...
  },
  "include": ["**/*.cy.ts", "**/*.ts"]
}

确认include数组包含所有Cypress测试文件，确保配置能覆盖到home.cy.ts。

3. 若无Cypress专属配置，在根目录tsconfig中添加专属块

如果你的项目没有单独的cypress/tsconfig.json，可以在根目录的tsconfig.json中添加Cypress测试文件的专属配置：

{
  "compilerOptions": {
    // 项目主代码的原有配置...
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
  // 添加Cypress专属配置
  "cypress": {
    "compilerOptions": {
      "isolatedModules": false
    },
    "include": ["cypress/**/*.ts"]
  }
}