未做任何修改时,为何Sass与NPM会突然停止工作、无法监听文件变更?
异常现象
站点开发过程中,Sass编译功能突然停止运行,同时NPM无法正常监听文件变更,执行相关命令时抛出以下错误:
npm ERR! errno -4058 npm ERR! enoent Error while executing: npm ERR! enoent undefined ls-remote -h -t ssh://git@github.com/gulpjs/gulp.git npm ERR! enoent npm ERR! enoent npm ERR! enoent spawn git ENOENT npm ERR! enoent This is related to npm not being able to find a file. npm ERR! enoent npm ERR! A complete log of this run can be found in: npm ERR! C:\Users\Symmetry Thomas\AppData\Roaming\npm-cache\_logs\2020-12-12T16_13_40_508Z-debug.log
报错本质:该错误属于NPM的ENOENT类异常,核心原因是NPM调用系统命令时无法定位到目标可执行文件,而非项目业务代码的逻辑问题。
排查解决步骤
- 首先排查系统Git环境配置
报错显示NPM需要执行git ls-remote拉取远程仓库依赖(这里指向gulp的git地址),这类操作依赖系统全局的Git可执行程序。如果系统找不到git命令,就会直接抛出spawn git ENOENT错误。
验证方式:打开系统CMD或PowerShell,执行git --version,如果返回提示“不是内部或外部命令,也不是可运行的程序”,就说明Git未正常加入系统环境变量。
修复方式:重新安装Git,安装过程中选择“将Git添加到系统PATH环境变量”的选项;如果已经安装过Git,手动将Git安装目录下的bin、cmd文件夹路径添加到系统环境变量的Path列表中,配置完成后重启终端再执行命令。 - 清理损坏的NPM缓存与项目依赖
如果Git环境正常仍报错,大概率是之前安装依赖时异常中断,导致NPM缓存中残留了错误的git依赖引用,触发后续的无效调用。
操作流程:- 删除项目根目录下的
node_modules文件夹、package-lock.json文件 - 终端执行
npm cache clean --force清空本地NPM缓存 - 重新执行
npm install重装项目依赖
- 删除项目根目录下的
- 修复连带的Sass编译、文件监听失效问题
依赖重装完成后,检查项目构建配置(如gulpfile.js、Sass编译任务配置),如果是Windows系统下的文件监听失效,可手动安装文件监听依赖chokidar,恢复NPM的文件变更检测能力。
内容的提问来源于stack exchange,提问作者Symmetry Thomas
相关产品推荐
相关产品推荐

