Chrome扩展开发调用Node JS内置函数execSync报错如何解决

你遇到的报错本质是运行环境认知偏差，和代码写法、是否初始化npm项目没有关系：

• Chrome Extension的所有脚本（background service worker、content script）都运行在Chrome的浏览器沙箱环境中，不是Node.js运行时，既不支持CommonJS的require语法，也没有Node.js的内置模块库。
• child_process.execSync是Node.js专属的系统级API，作用是直接调用本地操作系统的shell，浏览器出于最基础的安全限制，永远不会给网页/扩展开放直接执行本地命令的权限，哪怕你把npm项目初始化在扩展目录下，浏览器加载扩展时也不会识别Node的模块规则。
• Browserify等打包工具只能把不依赖系统底层能力的纯JS npm包转换为浏览器可运行的代码，碰到child_process这类需要调用操作系统原生能力的Node内置模块，哪怕强行打包，运行时也会因为没有对应底层支持直接报错，你的判断是正确的。

你之前尝试的引入代码：

const execSync = require('child_process').execSync;

不管换成require还是ES Module的import写法，在纯扩展环境下都不可能正常运行。

浏览器安全沙箱没有给纯前端/扩展上下文开放本地命令执行权限，所有实现方案都必须通过「本地有系统权限的中转程序」对接，没有纯扩展端的绕过方法，常用方案有两种：

方案1：使用Chrome官方Native Messaging机制（最规范） #

这是Chrome官方为扩展提供的和本地应用通信的标准方案，稳定性、安全性最好：

• 单独开发一个Native Messaging宿主程序，支持Node.js/Python/C++等所有可以读写标准输入输出的语言，这个程序安装在用户本地系统、在系统注册表中完成注册，本身运行在系统环境下，可以正常调用child_process执行任意shell命令。
• 在扩展的manifest.json中声明nativeMessaging权限，不需要引入任何Node模块，直接调用Chrome提供的原生APIchrome.runtime.sendNativeMessage给本地宿主发送要执行的命令参数。
• 本地宿主收到消息后执行对应命令，将执行结果通过标准输出返回给扩展即可。

注意：该方案需要用户在本地额外安装宿主程序，无法做到只安装扩展就直接使用，这是安全机制决定的，没有绕过路径。

方案2：本地启动极简Node中转服务 #

如果不想做Native Messaging的注册逻辑，可以用更轻量的HTTP中转方案：

• 在本地写一个极简的常驻Node服务，仅监听127.0.0.1的本地端口，服务接口实现接收命令参数、调用child_process执行命令、返回执行结果的逻辑，可以做成系统托盘程序配置开机自启。
• 在扩展的manifest.json中声明对应本地端口的跨域访问权限，扩展脚本通过fetch调用本地服务的接口，即可拿到命令执行结果。
• 该方案缺点是需要保证本地Node服务处于运行状态，否则扩展无法调用命令执行能力。

• 不要尝试寻找可直接在浏览器/扩展中调用shell的纯JS库，这类能力不可能在沙箱环境中直接实现，所有相关实现本质都依赖本地中转程序。
• 不要强行用Webpack/Browserify等工具把Node内置模块打包进扩展代码，打包只会合并JS代码，无法把Node依赖的系统底层能力带进浏览器沙箱，运行时必然报错。

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