Cypress 12.17.1在Windows10的VS Code中无自动补全(IntelliSense)求助

以下是针对Windows 10 + VSCode + Cypress 12.17.1的解决方案，无需手动添加const cypress = require("cypress")：

方法1：添加类型引用注释 #

在测试文件的最顶部添加三斜线类型指令，告诉VSCode加载Cypress的类型定义：

/// <reference types="cypress" />

该注释仅用于VSCode的类型检测，不会被编译执行，因此不会触发运行时错误，同时能正常触发cy.xxx及should('')等命令的自动补全。

方法2：配置项目类型识别文件 #

根据项目使用的是JavaScript还是TypeScript，在项目根目录创建或修改对应配置文件：

JavaScript项目（jsconfig.json） #

创建jsconfig.json并添加以下内容：

{
  "include": [
    "node_modules/cypress",
    "cypress/**/*.js",
    "cypress.config.js"
  ]
}

TypeScript项目（tsconfig.json） #

修改tsconfig.json，在compilerOptions中添加Cypress类型，并指定测试文件目录：

{
  "compilerOptions": {
    "types": ["cypress"]
  },
  "include": [
    "cypress/**/*"
  ]
}

配置完成后，VSCode会自动识别Cypress的全局类型，所有测试文件都能获得自动补全支持。

方法3：确认类型依赖（可选） #

如果以上方法仍不生效，可显式安装Cypress的类型声明依赖（Cypress 10+自带类型，但部分场景可能需要手动触发识别）：

npm install @types/cypress --save-dev

为什么添加require("cypress")会报错？ #

Cypress测试运行在浏览器环境中，而process是Node.js的全局变量，浏览器环境并不存在。require("cypress")会引入Node端的Cypress核心代码，导致运行时出现process is not defined错误，因此绝对不能在测试文件中添加该语句。

内容的提问来源于stack exchange，提问作者itkhanz