Node.js中cross-env运行原理：为何yarn可执行直接调用报找不到命令？

cross-env的核心运行机制 #

cross-env是Node.js生态中用于跨平台设置环境变量的工具，本身是用JavaScript编写的可执行脚本。它的核心能力是抹平不同操作系统设置环境变量的语法差异：Windows系统原生使用set 变量名=值的语法设置环境变量，macOS、Linux等类Unix系统则使用变量名=值的前缀语法，cross-env会自动识别当前运行的操作系统，调用对应原生语法完成环境变量设置后，再执行后续的目标命令。

yarn可正常执行、终端直接运行报错的原因 #

该差异由Node包管理工具的脚本执行机制决定：

• 通常cross-env会以局部依赖的形式安装在项目中，此时它的可执行文件会被下载到项目根目录的node_modules/.bin文件夹下。这个路径默认不会加入系统终端的环境变量PATH中，所以直接在终端输入cross-env相关命令时，zsh无法找到对应的可执行文件，就会抛出command not found: cross-env的错误。
• yarn（以及npm、pnpm等同类包管理工具）执行package.json中scripts配置的脚本时，会自动将当前项目的node_modules/.bin路径临时加入执行环境的PATH中，因此脚本中写的cross-env命令可以正常找到对应可执行文件，顺利运行。

如果需要直接在终端执行该命令，可选择两种方案：

• 全局安装cross-env：执行yarn global add cross-env或npm install cross-env -g，安装完成后cross-env的可执行文件会被加入系统PATH，全局终端均可调用
• 借助npx调用局部安装的版本：执行npx cross-env NODE_ENV=development node index.js即可，npx会自动检索项目node_modules/.bin路径下的可执行文件

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