在VS Code调试Protractor测试时出现模块外使用import的语法错误

• 第一处配置冲突：package.json中误添加的"type": "module"字段，会触发Node.js将项目下所有.js文件默认按ES Module规则解析，与tsconfig.json定义的commonjs模块输出规则、Protractor 7.x原生的CommonJS运行体系直接冲突。这也是很多同类方案未覆盖的隐蔽坑点，哪怕完成了ts-node配置也会触发跨模块语法报错。
• 第二处逻辑时序错误：你将ts-node转译注册逻辑写入了protractor.config.ts的beforeLaunch钩子内，但Protractor的运行流程是先读取、解析配置文件内容，再执行钩子逻辑——等于Protractor启动的第一步就会用Node原生CommonJS解析器直接读取配置文件里的ES Module语法（即开头的import语句），完全没有走到ts-node转译环节，自然会抛出“Cannot use import statement outside a module”的错误。这也是同类教程里常见的时序误导问题。

1. 修正package.json的模块规则 #

• 直接删除文件末尾的"type": "module"字段，将项目模块体系还原为和tsconfig、Protractor运行时对齐的CommonJS规则。
• 重新执行依赖安装，确保ts-node、typescript依赖版本完整可用，避免依赖缺失导致转译逻辑失效。

2. 调整ts-node转译逻辑的挂载时机 #

ts-node注册代码必须放在protractor.config.ts的最顶端、所有import语句之前执行，确保Protractor读取配置文件前，Node就已经具备TS语法转译能力：

// 配置文件最开头第一行执行ts-node注册
require('ts-node').register({
  project: require('path').join(__dirname, './tsconfig.json'),
  transpileOnly: true
});

// 之后再写入原有的import语句
import { Config, browser } from 'protractor';
let BeautifulReporter:any, SpecReporter:any;

// 原有config配置对象内容保持不变
export let config: Config = {
  // ... 原有配置内容无需改动
}

• 删除原来beforeLaunch钩子里冗余的require('ts-node').register()代码，避免重复注册引发冲突。

3. 优化VS Code调试配置（launch.json） #

原来的配置因为预构建任务、路径格式的问题，容易出现调试断点失效、路径解析错误的问题，调整为以下核心规则：

• 移除preLaunchTask的全量tsc预构建任务：依托ts-node的即时转译能力，不需要预先将所有TS文件编译为JS，减少路径匹配带来的问题。
• 统一使用正斜杠拼接路径，替换原来的Windows反斜杠格式，避免跨环境路径解析失败：

{
    "type": "pwa-node",
    "request": "launch",
    "name": "Debug Protractor Tests",
    "program": "${workspaceFolder}/Protractor/node_modules/protractor/bin/protractor",
    "args": [
        "${workspaceFolder}/Protractor/protractor.config.ts"
    ],
    "outFiles": [
        "${workspaceFolder}/Protractor/dist/out-tsc/**/*.js"
    ],
    "resolveSourceMapLocations": [
        "${workspaceFolder}/**",
        "!**/node_modules/**"
    ]
}

4. 校验tsconfig.json的规则匹配 #

现有tsconfig.json的基础配置无需大改，仅需确认两个规则和运行时对齐：

• 保持module字段值为"commonjs"，和ts-node转译的目标模块规则一致
• 不额外添加ES Module相关的编译配置，避免和Node运行时规则冲突

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