WebdriverIO+TypeScript编译报错：无法识别$标识符

问题根源 #

你遇到的TS2592错误是因为TypeScript无法识别WebdriverIO的全局定位器$和$$，误将其判定为jQuery的全局变量。核心原因有两个：

1. 依赖版本冲突：你同时使用了WebdriverIO v8和旧版的@wdio/sync（v7），而WDIO v8已移除同步模式，不再需要该依赖。
2. TypeScript配置未引入WDIO全局类型定义，导致编译器无法识别这些全局变量。

具体解决步骤 #

1. 移除过时依赖

卸载与WDIO v8不兼容的@wdio/sync：

npm uninstall @wdio/sync

2. 更新tsconfig.json配置

修改compilerOptions.types数组，添加WDIO全局类型，并移除旧的同步/异步类型：

"compilerOptions": {
    // 保留原有其他配置
    "types": [
        "mocha", 
        "node",
        "@wdio/globals/types" // 启用WDIO全局类型
    ],
    "moduleResolution": "node" // 新增，确保CommonJS模块解析正常
},

同时确认include数组包含你的测试文件和页面对象文件，确保TypeScript能正确扫描到这些文件。

3. 验证WebdriverIO配置（wdio.conf.js/ts）

确保你的WDIO配置中启用了自动编译和全局变量：

export const config = {
    // 其他配置
    autoCompileOpts: {
        autoCompile: true,
        tsNodeOpts: {
            project: './tsconfig.json',
            transpileOnly: true
        }
    },
    // 确保specs路径正确指向你的测试文件
    specs: [
        './test/**/*.spec.ts'
    ]
}

4. （可选）全局变量替代方案

如果全局类型仍不生效，可在测试文件顶部显式导入$/$$：

import { $, $$ } from '@wdio/globals'

验证修复 #

重新运行测试命令，TypeScript编译错误应该会消失：

npx wdio run wdio.conf.js

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