本文介绍如何通过环境变量 node_options 向 cypress 启动的所有 node.js 子进程传递自定义 cli 参数（如 --dns-result-order=ipv4first），无需修改 cypress 源码或依赖外部工具。
本文介绍如何通过环境变量 node_options 向 cypress 启动的所有 node.js 子进程传递自定义 cli 参数（如 --dns-result-order=ipv4first），无需修改 cypress 源码或依赖外部工具。
Cypress 在执行测试时会启动多个 Node.js 进程（例如：主进程、浏览器预处理器、任务运行器等），这些进程均继承自父 Shell 的 Node.js 启动配置。但 Cypress CLI 本身不提供直接透传 Node.js 原生命令行参数的机制（如 cypress run -- --dns-result-order=ipv4first 是无效的）。此时，标准且可靠的解决方案是利用 Node.js 内置的 NODE_OPTIONS 环境变量——它会在每个由当前环境派生的 Node.js 进程启动时自动应用指定的 CLI 标志，完美覆盖 Cypress 内部所有子进程。
✅ 推荐实践：通过 npm script 注入
在项目根目录的 package.json 中定义一个专用脚本，将 NODE_OPTIONS 作为前缀环境变量注入：
{
"scripts": {
"cypress:run": "NODE_OPTIONS='--dns-result-order=ipv4first' cypress run",
"cypress:open": "NODE_OPTIONS='--dns-result-order=ipv4first' cypress open"
}
}? Windows 用户注意：PowerShell 中应使用双引号并转义等号，CMD 中建议改用 set NODE_OPTIONS=--dns-result-order=ipv4first && cypress run；更推荐统一使用 cross-env 实现跨平台兼容：
"cypress:run": "cross-env NODE_OPTIONS='--dns-result-order=ipv4first' cypress run"
执行命令即可生效：
npm run cypress:run # 或使用 yarn yarn cypress:run
⚠️ 注意事项与验证方式
- NODE_OPTIONS 是 Node.js 官方支持的环境变量（Node.js CLI 文档），自 Node.js v10.10.0 起默认启用，但部分企业环境可能禁用（需检查 --disable-proto 等安全策略是否冲突）；
- 不建议在全局 shell 配置（如 .bashrc）中永久设置 NODE_OPTIONS，以免意外影响其他 Node.js 工具链；
- 可通过在 Cypress plugins/index.js 中添加 console.log(process.execArgv) 验证参数是否注入成功；
- 多参数组合时，用空格分隔，例如：NODE_OPTIONS='--max-old-space-size=4096 --dns-result-order=ipv4first'。
该方法轻量、可复现、符合 Node.js 生态规范，是解决 Cypress 场景下 Node 运行时定制需求的首选方案。
