You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Node.js安装sharp后出现Cannot find module 'node:util'错误,求正确安装方法

解决Sharp安装后"Cannot find module 'node:util'"的问题

你的Node.js v18.17.1原生支持node:util模块,出现该错误的核心原因是Sharp版本与当前Node环境不兼容,或安装过程中依赖缓存/文件损坏。以下是正确的修复与安装步骤:

彻底清理现有残留

  1. 卸载Sharp:
    npm uninstall sharp
    
  2. 删除项目依赖目录与锁文件:
    rm -rf node_modules package-lock.json yarn.lock
    
  3. 清空npm缓存:
    npm cache clean --force
    

安装兼容版本的Sharp

对于Node.js 18.x版本,推荐安装Sharp v0.32.x及以上版本,直接执行:

npm install sharp@latest

若最新版仍有问题,可指定稳定兼容版本:

npm install sharp@0.32.6

验证安装有效性

在项目根目录创建测试文件test-sharp.js,写入以下代码:

const sharp = require('sharp');
sharp('test.jpg')
  .resize(200, 200)
  .toBuffer()
  .then(() => console.log('Sharp加载正常'))
  .catch(err => console.error('Sharp加载失败:', err));

运行测试:

node test-sharp.js

若输出Sharp加载正常,说明安装成功。

额外排查项

  • 确认当前终端使用的Node版本确实为v18.17.1:
    node -v
    
  • 检查项目的webpack、babel等配置,确保未修改内置模块的解析规则,导致无法识别node:前缀的模块。

内容的提问来源于stack exchange,提问作者Terry Windwalker

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.28 03:22:45