GitHub 30k StarLosslessCut 无损视频剪辑从零部署完整教程 · 新手照着做就能跑起来 · 效率工具指南 · 原创教程本文详细介绍 LosslessCut 开源无损视频编辑器在 Windows 系统上的源码部署过程。涵盖 Electron 42 安装、Yarn 4 Berry 配置、FFmpeg 下载集成、electron-vite 构建等完整步骤。包含 Git clone RPC 失败、Yarn install 卡住、Electron 二进制下载失败、mitt patch 协议不支持等 5 个常见报错的解决方案。适用于 Windows 10/11 Node.js v20 环境。核心看点Windows 环境 LosslessCut 源码部署完整流程7步详解Yarn 4 Berry patch 协议报错 EUNSUPPORTEDPROTOCOL 解决方案Electron 二进制下载失败 TypeError fetch failed 镜像源配置Git clone 大仓库 RPC failed curl 56 schannel 浅克隆解决方案FFmpeg executable not found 错误修复download-ffmpeg-win32-x64 脚本项目简介你是否曾被视频剪辑软件的重新编码折磨过导出一个几分钟的片段要等半小时画质还变差了。LosslessCut就是来拯救你的——它基于 FFmpeg直接对原始数据流进行拷贝不重新编码、不损失画质、速度极快。剪掉视频中的广告、提取音乐、合并素材统统秒级完成。LosslessCut 是一款基于 FFmpeg 的跨平台无损视频/音频编辑器主打极速无损剪切与合并无需重新编码。它的核心价值在于无损操作剪切、合并、格式转换都不重新编码直接拷贝数据流。这意味着处理一个 2GB 的视频文件只需要几秒钟而且输出文件与源文件画质完全一致。本文记录了从克隆代码到成功运行的完整过程包含所有踩坑和解决方案。核心功能一览无损剪切/裁剪视频和音频无损合并/拼接同参数文件多轨道编辑添加/删除/替换音轨、字幕轨无损格式转换如 MKV 转 MP4从视频提取帧为 JPEG/PNG黑场检测、静音检测、场景切换检测导入/导出剪切点列表CSV、YouTube 章节、DaVinci/XML 等项目技术栈维度详情应用框架Electron 42桌面应用前端框架React 19 TypeScript 6构建工具electron-vite 5 Vite 7核心引擎FFmpeg / FFprobe媒体处理包管理器Yarn 4.11.0Berry 模式UI 库Radix UI Themes、Sass状态管理Immer、React-use国际化i18next支持 30 语言其他关键依赖execa进程调用、electron-store持久化、expressHTTP API、winston日志项目概况项目名称LosslessCutGitHub 地址github.com/mifi/lossless-cutStar 数30,000最新版本v3.69.02026年6月许可证GPL-2.0完全免费开源技术栈Electron 42 React 19 TypeScript 6 FFmpeg环境准备部署前需要准备以下软件按表格检查你的环境软件要求版本实测版本说明Node.jsv16建议 v20v22.23.1LTS 版本即可自带 CorepackGit任意版本2.34.1用于克隆代码7-Zip任意版本-解压 FFmpeg需加入 PATHFFmpeg任意版本4.4.2系统自带开发模式从 PATH 读取也可用脚本下载提示Node.js 下载地址 https://nodejs.org/ 安装时勾选所有默认选项即可。Corepack 是 Node.js 自带的包管理器版本管理工具无需单独安装。详细部署步骤步骤 1克隆项目代码必须浅克隆打开 PowerShell 或 CMD执行以下命令。必须加--depth 1参数进行浅克隆否则仓库太大容易中断。gitclone--depth1https://github.com/mifi/lossless-cut.gitcdlossless-cut注意如果不加--depth 1完整克隆 3700 次提交的大仓库时容易出现RPC failed; curl 56 schannel错误因为 Windows 默认的 Schannel SSL 后端传输大数据不稳定。执行结果成功克隆项目代码目录包含 README.md、package.json、src/ 等核心文件。步骤 2启用 Corepack 激活 Yarn 4项目使用 Yarn 4.11.0Berry 版通过 Corepack 激活。先以管理员身份运行 PowerShell 执行启用命令然后进入项目目录验证版本。# 以管理员身份运行 PowerShellcorepackenable# 进入项目目录必须在项目目录内执行cdC:\Users\你的用户名\lossless-cutyarn--version注意corepack enable需要管理员权限否则报EPERM: operation not permitted错误。右键点击 PowerShell → 以管理员身份运行即可。必须在项目目录内执行yarn --versionCorepack 才会读取项目的.yarnrc.yml并下载 Yarn 4.11.0。在主目录执行会下载 Yarn 1.22.22版本不对。执行结果输出4.11.0表明 Yarn 4 Berry 已通过 Corepack 激活使用项目内捆绑的.yarn/releases/yarn-4.11.0.cjs。步骤 3安装项目依赖方式一Yarn install官方推荐在项目目录中执行 Yarn install会自动下载 1257 个依赖包。yarninstall安装过程会显示几个警告eslint-plugin-react-hooks 版本冲突、react-leaflet/core peer dependency 缺失这些都是非致命警告不影响运行。安装时间约 5-10 分钟取决于网络速度。成功标志看到Done with warnings in 9m 29s表示安装完成。警告YN0060、YN0002可以忽略。踩坑预警如果 Yarn install 卡在 Fetch 步骤超过 5 分钟无进展.yarn/cache/目录始终为空说明 Yarn 4 Berry 在当前网络环境下无法正常获取包。此时请改用方式二npm install。方式二npm install替代方案解决 Yarn 卡住问题由于 Yarn 4 Berry 的 mitt 包使用了patch:协议npm 不支持该协议需先修改package.json将第 156 行mitt:patch:mittnpm%3A3.0.1#~/.yarn/patches/mitt-npm-3.0.1-ce290ffa77.patch,改为mitt:^3.0.1,然后执行npminstall--legacy-peer-deps执行结果安装 1276 个包耗时约 36 秒postinstall 脚本自动执行electron-builder install-app-deps成功安装原生依赖有若干 deprecated 警告inflight、glob、eslint 等不影响使用1 个 low severity 漏洞可忽略added1276packages, and audited1277packagesin36s提示使用 npm 安装后后续步骤中请用npx代替yarn运行脚本如npx electron-vite dev。步骤 4安装 Electron 二进制文件Yarn install 或 npm install 完成后Electron 的 JS 代码已安装但二进制文件约 215MB可能未自动下载。先检查是否存在# 检查是否存在dirnode_modules\electron\dist\electron.exe# 如果不存在手动下载nodenode_modules\electron\install.js警告如果node node_modules\electron\install.js报TypeError: fetch failed是因为 Electron 二进制从 GitHub 下载国内网络不稳定。解决方案设置镜像源后重试# 设置 Electron 镜像源淘宝镜像$env:ELECTRON_MIRRORhttps://npmmirror.com/mirrors/electron/# 重新下载nodenode_modules\electron\install.js执行结果Electron 42.8.1 二进制文件下载成功约 215MB位于node_modules/electron/dist/目录。步骤 5下载 FFmpeg打包用项目内置了 FFmpeg 下载脚本。开发模式下应用从系统 PATH 读取 FFmpeg但打包时需要项目内的 FFmpeg。方式 A开发模式推荐确保系统 PATH 中有 ffmpeg 命令即可ffmpeg-version方式 B打包模式运行项目内置下载脚本yarndownload-ffmpeg-win32-x64注意此脚本依赖 7-Zip。如果报找不到7z命令需要安装 7-Zip 并将安装目录加入系统 PATH。下载完成后 FFmpeg 会放在ffmpeg\win32-x64\lib\目录。执行结果系统已有 FFmpeg 4.4.2开发模式直接可用打包模式则下载到项目内。步骤 6构建项目执行 electron-vite 构建命令将源码编译为可运行的生产产物。npx electron-vite build执行结果构建成功耗时约 19 秒。输出目录out/包含三部分out/main/index.js主进程72KBout/preload/index.cjs预加载脚本0.3KBout/renderer/渲染进程含 index.html assets/总构建产物大小34MB。步骤 7启动开发模式一切就绪后启动开发模式。Vite 开发服务器会先编译主进程和预加载脚本然后启动 Electron 窗口。npx electron-vite dev-w提示-w参数启用文件监听watch 模式修改代码后自动重新编译。成功标志Electron 窗口弹出标题栏显示 “LosslessCut 3.69.0”菜单栏有 文件、编辑、片段、查看、工具、帮助 等选项。Vite 开发服务器成功启动http://127.0.0.1:3001/。如果弹出 “FFmpeg executable not found” 对话框说明步骤 5 的 FFmpeg 还没下载按步骤 5 操作后重启即可。图LosslessCut 3.69.0 启动成功显示拖放文件引导界面踩坑记录与解决方案坑 1Git clone 失败RPC 错误错误信息error: RPC failed; curl 56 schannel: server closed abruptly fatal: early EOF fatal: fetch-pack: invalid index-pack output原因仓库有 3700 次提交体积大。Windows 默认 Schannel SSL 后端传输大数据不稳定网络波动导致连接中断。解决方案使用浅克隆只下载最新一次提交gitclone--depth1https://github.com/mifi/lossless-cut.git或切换 SSL 后端并增大缓冲区gitconfig--globalhttp.postBuffer524288000gitconfig--globalhttp.sslBackend opensslgitclone https://github.com/mifi/lossless-cut.git坑 2Yarn install 卡在 Fetch 步骤问题描述执行yarn install后Resolution 和 Post-resolution validation 步骤快速完成但 Fetch 步骤始终无进展。等待超过 5 分钟.yarn/cache/目录始终为空。尝试配置 npmmirror 镜像和默认 npm registry 均无效。原因Yarn 4 Berry 使用自定义的包获取机制在某些网络环境下可能存在兼容性问题。具体原因可能是 Yarn 4 的 HTTP 请求方式与特定网络代理/防火墙不兼容或其内部并发下载机制在某些环境下死锁。解决方案改用 npm 安装作为替代方案修改package.json中的mitt依赖将patch:协议改为普通版本号^3.0.1执行npm install --legacy-peer-deps使用npx代替yarn运行脚本如npx electron-vite dev影响mitt 的 patch 修改的是 exports 字段ESM/CJS 模块解析在实际开发中未发现功能异常--legacy-peer-deps跳过 peer dependency 版本检查有若干警告但不影响运行坑 3Electron 二进制下载失败TypeError fetch failed错误信息TypeError: fetch failed原因Electron 二进制215MB从 GitHub Releases 下载国内网络不稳定。Electron 包的 postinstall 脚本在某些环境下可能未正确触发或下载被中断但未报错。解决方案设置淘宝镜像源后重试# 设置 Electron 镜像源淘宝镜像$env:ELECTRON_MIRRORhttps://npmmirror.com/mirrors/electron/# 手动触发下载nodenode_modules\electron\install.js坑 4mitt patch 协议报错 EUNSUPPORTEDPROTOCOL错误信息npm error code EUNSUPPORTEDPROTOCOL npm error Unsupported URL Type patch:: patch:mittnpm%3A3.0.1#~/.yarn/patches/mitt-npm-3.0.1-ce290ffa77.patch原因项目使用 Yarn 4 Berry 的 patch 协议修改 mitt 包的 exports 字段。npm 不支持此协议。解决方案将package.json中 mitt 的依赖从 patch 格式改为普通版本号mitt:^3.0.1patch 修改的是 mitt 的 ESM/CJS 模块解析配置在 Electron 环境中未发现实际影响。坑 5启动后提示 FFmpeg not found问题应用启动后弹出 “Fatal: FFmpeg executable not found”提示找不到ffmpeg\win32-x64\lib\ffmpeg.exe。原因开发模式下需要系统 PATH 中有 FFmpeg或项目内已下载 FFmpeg。解决方案# 方式一使用项目内置脚本下载需 7-Zipyarndownload-ffmpeg-win32-x64# 方式二手动安装 FFmpeg 到系统 PATH提示开发模式下只要系统 PATH 中能找到ffmpeg命令即可正常运行不一定要用项目内置脚本下载。功能验证验证项结果说明依赖安装通过1276 个包成功安装postinstall 正常执行Electron 原生依赖通过electron-builder install-app-deps 成功Electron 二进制通过v42.8.1 下载成功手动触发项目构建通过electron-vite build 成功产物 34MBVite 开发服务器通过http://127.0.0.1:3001/ 正常启动主进程编译通过out/main/index.js 生成预加载脚本编译通过out/preload/index.cjs 生成渲染进程编译通过out/renderer/ 含 HTMLJSCSS字体FFmpeg 可用性通过系统 PATH 中 ffmpeg 4.4.2 可用需下载后生效Electron 窗口启动通过Windows 环境下 GUI 正常启动常见问答Q1Yarn 1 和 Yarn 4 有什么区别Yarn 1Classic是 2017 年的老版本已停止维护Yarn 4Berry是现代版本支持 patch 协议、插件系统、PnP 安装等。本项目通过.yarnrc.yml指定 Yarn 4.11.0必须用 Corepack 激活。Q2不想从源码编译可以直接用吗可以去 GitHub Releases 页面下载LosslessCut-win-x64.7z用 7-Zip 解压后直接运行 exe 即可无需任何开发环境。Q3安装依赖时那些警告需要处理吗不需要。YN0060eslint-plugin-react-hooks 版本冲突和 YN0002react-leaflet/core peer dependency 缺失都是非致命警告不影响项目运行和构建。Q4支持哪些视频格式支持 MP4、MOV、WebM、Matroska(MKV)、OGG、WAV 等主流格式。视频编码支持 H264、AV1、VP8、VP9、H265 等。不支持的格式可以通过 File 菜单中的 “Fastest: FFmpeg-assisted playback” 选项转换播放。Q5Windows 7/8 能用吗v3.52.0 起不再支持 Windows 8.1 及以下。推荐使用 Windows 10/11。旧版本仍可在旧系统上使用但无法获得新功能更新。总结LosslessCut 部署难度中等偏低。项目文档完善CONTRIBUTING.md 有明确的开发环境搭建指南。主要踩坑点集中在三个方面Git 大仓库克隆中断用浅克隆解决、Electron 二进制下载失败用镜像源解决、FFmpeg 缺失用内置脚本下载。整体来说只要按本文步骤操作15 分钟内可以完成部署。适合人群有基本命令行操作经验、对 Electron/React 有一定了解、需要定制或贡献代码的开发者。普通用户建议直接下载 Release 包使用。完整命令速查# 1. 克隆代码浅克隆gitclone--depth1https://github.com/mifi/lossless-cut.gitcdlossless-cut# 2. 启用 Yarn 4corepackenable# 3. 安装依赖Yarn 方式如卡住见下方 npm 方式yarninstall# 如果 Yarn 卡住改为 npm 方式# 手动修改 package.json 中 mitt 行为 mitt: ^3.0.1# npm install --legacy-peer-deps# 4. 安装 Electron 二进制如未自动下载# $env:ELECTRON_MIRRORhttps://npmmirror.com/mirrors/electron/# node node_modules\electron\install.js# 5. 下载 FFmpeg打包用需 7-Zipyarndownload-ffmpeg-win32-x64# 6. 构建项目npx electron-vite build# 7. 启动开发模式npx electron-vite dev-w# 8. 打包 Windows 可执行文件可选# npx electron-builder --win zip --x64项目地址github.com/mifi/lossless-cut。觉得有帮助请点赞收藏关注我获取更多开源项目部署教程。觉得有用点赞收藏关注三连点赞 | 留言 | 收藏 | 转发标签Electron · Yarn4 · FFmpeg · 开源部署 · Windows · 视频剪辑 · React · TypeScript