本文介绍通过环境变量 NODE_OPTIONS 向 Cypress 启动的 Node.js 进程注入自定义参数（如 --dns-result-order=ipv4first）的可靠方法，无需修改 Cypress 源码或依赖插件。
本文介绍通过环境变量 node_options 向 cypress 启动的 node.js 进程注入自定义参数（如 `--dns-result-order=ipv4first`）的可靠方法，无需修改 cypress 源码或依赖插件。
Cypress 本身不提供 CLI 参数直接透传 Node.js 启动选项（如 --dns-result-order=ipv4first），这是因为 Cypress 的主进程、测试运行器及浏览器预加载脚本均运行在独立的 Node.js 实例中，而这些实例默认不继承用户启动命令的原始 Node 参数。官方文档也未暴露相关配置入口。
但 Node.js 自 v10 起支持全局启动选项控制机制：通过 NODE_OPTIONS 环境变量，可向当前 shell 下所有由该 Node.js 可执行文件启动的子进程自动注入指定 CLI 参数。该机制完全符合 Node.js 官方规范，且对 Cypress 全链路生效——包括 Cypress CLI 进程、cypress open 的 GUI 主进程、cypress run 的 runner 进程，以及测试中通过 cy.task() 或 cy.exec() 触发的 Node 子任务。
✅ 正确做法是在 package.json 中定义带环境变量的 npm script：
{
"scripts": {
"cypress:run": "NODE_OPTIONS='--dns-result-order=ipv4first' cypress run",
"cypress:open": "NODE_OPTIONS='--dns-result-order=ipv4first' cypress open"
}
}执行时使用：
npm run cypress:run # 或 yarn cypress:run
⚠️ 注意事项：
- NODE_OPTIONS 是仅限 Node.js 进程识别的环境变量，不会影响浏览器环境或 Cypress 测试代码中的 cy.visit() 等前端行为；
- 多参数需用空格分隔，例如：NODE_OPTIONS='--dns-result-order=ipv4first --trace-warnings'；
- 在 Windows PowerShell 中需改用双引号并转义等号：$env:NODE_OPTIONS="--dns-result-order=ipv4first"；推荐统一使用 cross-env 提升跨平台兼容性：
"scripts": {
"cypress:run": "cross-env NODE_OPTIONS='--dns-result-order=ipv4first' cypress run"
}（需先安装：npm install --save-dev cross-env）
? 补充说明：该方案不仅适用于 DNS 相关参数，还可用于启用实验性特性（如 --enable-source-maps）、调试（--inspect）、内存调优（--max-old-space-size=4096）等场景。只要参数被 Node.js 原生支持，即可通过 NODE_OPTIONS 安全注入。
综上，利用 NODE_OPTIONS 是目前最轻量、最标准、最可维护的解决方案——它不侵入 Cypress 内部逻辑，不增加构建复杂度，且与 CI/CD 流水线天然兼容。
