Cypress引入replace-in-file后报找不到babel-preset-es2015模块错误

DevOps 小满

2026-8-30

问题背景

在Cypress项目代码中添加replace-in-file引入语句与文件替换配置后，运行触发报错：Cannot find module babel-preset-es2015，已完成babel安装与对应preset配置操作后，报错仍未消除。
触发报错的相关代码：

const replace = require("replace-in-file");
const options = {
    files: "./config/dashboardData.json",
    configFile: true,
    from: /}\n{/g,
    to: ",\n",
};

排查思路

核对babel preset包名与版本适配性：babel 6版本使用babel-preset-es2015作为包名，babel 7及以上版本已废弃该独立preset，统一整合为@babel/preset-env，包名变更后直接沿用旧配置会触发模块找不到报错。
确认依赖加载上下文：Cypress插件运行时的执行上下文与项目本地Node上下文存在隔离，若babel相关依赖仅全局安装、或安装路径不在Cypress默认模块查找范围内，会出现依赖已安装但无法识别的问题。
检查配置项合法性：configFile是babel的专属配置参数，不属于replace-in-file的支持配置项，错误传入该参数可能触发库内部异常走babel兜底解析逻辑，主动查找旧版preset依赖。
确认replace-in-file版本：v6以下的旧版本replace-in-file内部硬编码依赖了babel-preset-es2015，不会读取项目本地的babel配置，会直接在自身依赖目录下查找对应包，缺失时直接抛错。

可落地解决方案

替换废弃的babel preset依赖
先卸载旧版preset，安装适配babel7+的官方preset包：

npm uninstall babel-preset-es2015
npm install @babel/core @babel/preset-env --save-dev

同步修改项目中的babel配置文件（.babelrc或babel.config.js），将presets配置更新为：

{
  "presets": ["@babel/preset-env"]
}

修正replace-in-file配置
删除配置中无效的configFile: true字段，补充替换执行逻辑，修正后代码如下：

const replace = require("replace-in-file");
const options = {
    files: "./config/dashboardData.json",
    from: /}\n{/g,
    to: ",\n",
};

// 执行文件替换
replace(options)
  .then(res => console.log("文件替换完成", res))
  .catch(err => console.error("文件替换失败", err));

修复Cypress上下文的模块查找路径
如果是在Cypress的plugins目录文件中编写上述逻辑，在文件顶部添加模块路径兜底配置，避免上下文隔离导致的依赖查找失败：

const path = require("path");
module.paths.push(path.resolve(process.cwd(), "node_modules"));
// 后续再编写replace-in-file的引入与执行逻辑

升级依赖版本
若上述操作后仍存在报错，直接将replace-in-file升级到最新稳定版，v6及以上版本已经移除了对旧版babel-preset-es2015的硬依赖，不会再触发该类报错。

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