Node Video类工具卡顿、导出失败或提示“内存不足”,主因是Node.js缓存与视频代理文件双重堆积;需同步清理npm/yarn缓存、node_modules残留及视频工作区临时目录,并重置模块缓存、迁移全局缓存至非系统盘。

Node Video类工具(如基于Electron或FFmpeg封装的本地视频处理应用)运行卡顿、导出失败或提示“内存不足”,往往不是显存或物理内存问题,而是其底层Node.js环境缓存与视频代理文件双重堆积所致;必须同步清理npm/yarn缓存、node_modules残留及视频工作区临时目录。
定位并清空Node Video依赖的包管理器缓存
先确认你当前使用的包管理器——多数Node Video工具由npm或yarn驱动,缓存路径默认落在C盘用户目录下,长期积累可达数GB。
打开终端,依次执行:
① 查看npm缓存实际位置:npm config get cache
② 查看yarn缓存实际位置:yarn cache dir
③ 执行强制清空(请核对上一步输出路径,【误删非缓存目录将导致全局npm命令失效】):nvm cache clear && yarn cache clean
这一步会清除所有已下载但未安装的包压缩包,释放空间立竿见影;若提示权限拒绝,在Windows上以管理员身份运行终端,macOS/Linux加sudo前缀。
删除视频处理生成的代理与缓存目录
Node Video工具(如Shotcut Node版、自研Electron剪辑器等)在导入高清素材时,会自动生成代理文件(proxy)、预览缓存(cache)、时间线快照(.snapshots)三类临时数据,它们不随项目关闭自动删除。
方法一:通过软件内置路径清理
启动Node Video → 设置 → 高级 → 清理缓存 → 勾选“代理文件”“预览帧缓存”“历史快照” → 点击“立即清理”
方法二:手动定位并删除(更彻底)
Windows用户进入:%APPDATA%NodeVideocache 和 %LOCALAPPDATA%TempNodeVideo_*
macOS用户进入:~/Library/Caches/io.nodevideo.* 与 /private/var/folders/xx/yy/T/NodeVideo-*(用ls -t | head -5找最新创建的临时目录)
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r
注意:不要删除projects或presets文件夹,那是你的工程和模板。
重置Node.js模块缓存避免热重载异常
当你频繁修改Node Video插件或自定义脚本后出现功能错乱、UI不刷新,大概率是require缓存未更新。这不是磁盘空间问题,但会引发逻辑性卡顿。
在应用主进程代码中插入以下片段(通常为main.js或index.js):
Object.keys(require.cache).forEach(key => { if (key.includes('nodevideo') || key.includes('plugin')) delete require.cache[key]; });
这行代码只清除含nodevideo或plugin关键词的模块缓存,不影响核心Electron或Node原生模块;跳过此步可能导致新JS文件始终不生效。
迁移npm全局缓存到非系统盘(一劳永逸)
如果你的Node Video依赖大量全局CLI工具(如ffmpeg-static、ffprobe-static),每次npm install -g都会往C盘塞几百MB,必须切断源头。
第一步:新建非C盘缓存目录,例如D:
ode_cache和D:
ode_global
第二步:在终端执行(路径请严格对应你创建的实际目录):
npm config set cache "D:\node_cache"
npm config set prefix "D:\node_global"
第三步:验证是否生效:npm config get cache 和 npm config get prefix 输出应为D盘路径
【执行前务必关闭所有Node Video实例,否则配置可能被进程锁定写入失败】


















