解决百度网盘安装报错:D 盘 package.json 触发 Electron ESM/CJS 冲突

解决百度网盘安装报错:D 盘 package.json 触发 Electron ESM/CJS 冲突

背景与现象

在 Windows 上安装或启动百度网盘时,主进程报错并直接退出:

复制代码
A JavaScript error occurred in the main process
Uncaught Exception:
Error [ERR_REQUIRE_ESM]: requireO of ES Module
D:\BaiduNetdisk\module\BrowserEngine\resources\core.asar\main.js from
D:\BaiduNetdisk\module\BrowserEngine\resources\app.asar\dist\electron\entry.js not
supported.
main.js is treated as an ES module file as it is a js file whose nearest parent
package.json contains "type": "module" which declares all .js files in that package
scope as ES modules.
Instead rename main.js to end in .cjs, change the requiring code to use dynamic
importO which is available in all CommonJS modules, or change "type": "module" to
'type": "commonjs" in D:\package.json to treat all .js files as CommonJS (using .mjs for
all ES modules instead).
...

提示里有一条非常关键的线索:

  • main.js is treated as an ES module
  • 最近的父级 package.jsonD:\package.json

原因分析

Node/Electron 会按照"就近包作用域"的规则来解析模块类型:

  • 如果某个 .js 文件向上找到最近的 package.json,且其中 "type": "module"
    该作用域内的所有 .js 都会按 ESM 解析。
  • 百度网盘的 Electron 入口仍在使用 require() 加载 main.js
    但它被判定为 ESM,于是抛出 ERR_REQUIRE_ESM

换句话说:D 盘根目录的 package.json 把整个 D:\ 变成了 ESM 作用域

导致 D:\BaiduNetdisk\... 下的 .js 被错误地当成 ES Module。

解决方案(本次采用)

在百度网盘安装目录下放置一个更近的 package.json,覆盖模块类型:

D:\BaiduNetdisk\package.json

内容如下:

json 复制代码
{
  "type": "commonjs"
}

这样 D:\BaiduNetdisk\ 及其子目录中的 .js 会按 CommonJS 解析,

Electron 的 require() 能正常工作。

验证方法

  • 重新启动百度网盘,确认不再弹出 ERR_REQUIRE_ESM
  • 若仍报错,检查是否还有其他上层目录存在影响模块解析的 package.json

可选方案

  1. 把百度网盘安装到不受 D:\package.json 影响的路径(如 C:\Program Files\BaiduNetdisk)。
  2. D:\package.json 不是必需文件,可移除或修改其 "type" 配置。

回滚方式

如需回滚,只需删除或改回以下文件:

  • D:\BaiduNetdisk\package.json

小结

这类报错往往不是应用本身的问题,而是 安装路径中的 package.json 改变了模块解析规则

关键是识别报错里出现的"最近父级 package.json"提示,然后用更近的包作用域进行覆盖。


如果你的环境中存在多个 Node 项目,建议不要在磁盘根目录放 package.json

避免对其它程序产生意外影响。

相关推荐
海兰7 小时前
【应用】基于 Next.js 16 + Python mplfinance的金融K线图与技术指标可视化平台(三)
javascript·python·金融
小磊哥er8 小时前
深入解构Claude Code - 第 7 篇 · 连接外面的世界
javascript·ai编程
小磊哥er8 小时前
深入解构Claude Code - 第 6 篇 · 终端里的图形界面
javascript·ai编程
海兰8 小时前
【应用】基于 Next.js 16 + Python mplfinance的金融K线图与技术指标可视化平台(一)
javascript·python·金融
可乐鸡翅yeah_10 小时前
hls.js 内存泄漏实战排查,直播 M3U8 长时间播放异常定位方案
开发语言·javascript·python·django·ecmascript·m3u8·m3u8在线
可乐鸡翅yeah_10 小时前
第三方接口对接 M3U8 流媒体排坑实战,解决外部服务商流兼容难题
前端·javascript·python·django·html·m3u8·m3u8在线
默_笙10 小时前
🏠 「LLM Notes」:我用 Next.js + Redis 给自己造了个笔记博客
前端·javascript
ruanCat12 小时前
Prettier 明明执行成功,Markdown 为什么还是没变?一次插件误诊复盘
前端·javascript·node.js
软件开发技术深度爱好者12 小时前
在线学习实践 TypeScript 的官方Playground(演练场)使用介绍
javascript·学习·typescript
小磊哥er14 小时前
深入解构Claude Code - 第 5 篇 · 每次提问都给 AI 塞了什么资料
javascript·ai编程