Upscayl本地构建报错快速解决完整指南从依赖安装到Windows打包【免费下载链接】upscayl Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl如果你想在本地构建 Upscayl 并自己打包出安装包大概率会卡在三处npm install/npm run build直接失败、electron-builder 找不到 ncnn 后端二进制、打包好的 exe 启动即闪退。本文不复述背景按现象 → 原因 → 修复 → 验证的固定节奏把每类报错一次讲透。先定位再动手症状对号入座敲任何命令之前先对照下面的分流清单确定你该读哪一节现象最可能的原因对应小节npm run build报找不到tsc或 node-gyp 编译失败Node 版本与项目锁定版本不符、依赖未装全依赖安装排查electron-builder 报ENOENT ... resources/win/binncnn 后端二进制没有下载资源文件缺失排查npm run dist:win跑完但 dist/ 里没有产物tsc → build → electron-builder链条在前一步就断了打包与Vulkan排查exe 启动即退日志区出现 Vulkan 初始化失败GPU 不支持 Vulkan / 驱动损坏打包与Vulkan排查Upscayl依赖安装与Node版本不匹配排查现象git clone后npm install看起来成功但npm run build一执行就报找不到tsc或刷出一堆 peer dependency 冲突。原因判断package.json 里 Volta 锁定 Node 18.20.5Next 15、Electron 33、electron-builder 25 这套组合只在该版本上稳定用 Node 20/22 时原生模块编译经常翻车。修复步骤node -v npm cache clean --force rm -rf node_modules package-lock.json npm install第一条命令输出必须是v18.20.x不是就先换版本再清依赖重装。验证方法npx tsc --version正常打印版本号npm run tsc执行完无输出即通过build脚本内部会先跑 tsc 和 schema 校验再构建前端。electron-builder“resources/bin缺失”报错排查现象打包阶段出现Error: ENOENT: no such file or directory, open resources/win/bin/upscayl-bin.exe原因判断build 配置里的extraFiles声明了把resources/${os}/bin拷进安装产物但仓库里只放了下载脚本二进制本体需要自己拉取这是新人最常踩的坑。⚠️ 跳过这一步后面所有打包命令都会在这中断。修复步骤./update_upscayl_ncnn_binaries.sh在 Windows 上改从脚本抓取的来源手动下载把upscayl-bin.exe和vcomp140.dll放进resources/win/bin/完整清单看 update_upscayl_ncnn_binaries.sh。验证方法ls resources/win/bin应列出上述文件再跑npm run pack-app等价electron-builder --dir快速打包不产安装包确认解包目录里出现了resources/bin。Windows打包命令与Vulkan初始化失败排查现象npm run dist:win跑完但 dist/ 里没有 exe或 exe 双击即退应用内日志区打出Failed to initialize Vulkan。原因判断前者几乎一定是tsc → build → electron-builder链条中靠前的一步失败了只是你只看了结尾——翻回日志第一个红色报错。后者是 GPU 侧问题不支持 Vulkan 1.1多数核显不行、驱动损坏或系统处于省电模式详见 docs/troubleshooting/windows.mdx。修复步骤# 1. 重装显卡驱动系统电源切到“高性能” # 2. 显卡控制面板开启“硬件加速 GPU 计划” # 3. 双显卡笔记本关闭双显卡切换或在设置里指定 GPU ID npm run dist:win验证方法重打之前先用 VulkanCapsViewer 确认 GPU 可用应用启动后看设置页 LOGS 区的实时日志文件在%APPDATA%\Upscayl\logs位置说明见 docs/troubleshooting/logs.mdx。验证标准构建命令流程与产物检查清掉旧产物后跑标准流程npm run clean npm run build npm run dist:win成功标志有三条缺一不可dist/下出现upscayl-2.15.0-win.exeNSIS 安装器和upscayl-2.15.0-win.zip便携版命名由artifactName规则决定日志尾部出现building targetnsis filedist/upscayl-2.15.0-win.exe archsx64其后不再有error双击 exe 能进入下图所示的主界面而不是秒退进阶调优与求助渠道你可以把每次改动后的验证换成npm run pack-app只出解包目录、跳过安装器打包省时一个量级你可以执行DEBUG* npx electron-builder --win打开 electron-builder 调试日志精确定位缺失文件是在哪一步没被拷进去问题仍未解决时通过设置页 LOGS → COPY LOGS 复制完整日志附带到项目 Discussions 提问并先过一遍 docs/troubleshooting/general-fixes.mdx。【免费下载链接】upscayl Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Upscayl本地构建报错快速解决完整指南：从依赖安装到Windows打包
Upscayl本地构建报错快速解决完整指南从依赖安装到Windows打包【免费下载链接】upscayl Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl如果你想在本地构建 Upscayl 并自己打包出安装包大概率会卡在三处npm install/npm run build直接失败、electron-builder 找不到 ncnn 后端二进制、打包好的 exe 启动即闪退。本文不复述背景按现象 → 原因 → 修复 → 验证的固定节奏把每类报错一次讲透。先定位再动手症状对号入座敲任何命令之前先对照下面的分流清单确定你该读哪一节现象最可能的原因对应小节npm run build报找不到tsc或 node-gyp 编译失败Node 版本与项目锁定版本不符、依赖未装全依赖安装排查electron-builder 报ENOENT ... resources/win/binncnn 后端二进制没有下载资源文件缺失排查npm run dist:win跑完但 dist/ 里没有产物tsc → build → electron-builder链条在前一步就断了打包与Vulkan排查exe 启动即退日志区出现 Vulkan 初始化失败GPU 不支持 Vulkan / 驱动损坏打包与Vulkan排查Upscayl依赖安装与Node版本不匹配排查现象git clone后npm install看起来成功但npm run build一执行就报找不到tsc或刷出一堆 peer dependency 冲突。原因判断package.json 里 Volta 锁定 Node 18.20.5Next 15、Electron 33、electron-builder 25 这套组合只在该版本上稳定用 Node 20/22 时原生模块编译经常翻车。修复步骤node -v npm cache clean --force rm -rf node_modules package-lock.json npm install第一条命令输出必须是v18.20.x不是就先换版本再清依赖重装。验证方法npx tsc --version正常打印版本号npm run tsc执行完无输出即通过build脚本内部会先跑 tsc 和 schema 校验再构建前端。electron-builder“resources/bin缺失”报错排查现象打包阶段出现Error: ENOENT: no such file or directory, open resources/win/bin/upscayl-bin.exe原因判断build 配置里的extraFiles声明了把resources/${os}/bin拷进安装产物但仓库里只放了下载脚本二进制本体需要自己拉取这是新人最常踩的坑。⚠️ 跳过这一步后面所有打包命令都会在这中断。修复步骤./update_upscayl_ncnn_binaries.sh在 Windows 上改从脚本抓取的来源手动下载把upscayl-bin.exe和vcomp140.dll放进resources/win/bin/完整清单看 update_upscayl_ncnn_binaries.sh。验证方法ls resources/win/bin应列出上述文件再跑npm run pack-app等价electron-builder --dir快速打包不产安装包确认解包目录里出现了resources/bin。Windows打包命令与Vulkan初始化失败排查现象npm run dist:win跑完但 dist/ 里没有 exe或 exe 双击即退应用内日志区打出Failed to initialize Vulkan。原因判断前者几乎一定是tsc → build → electron-builder链条中靠前的一步失败了只是你只看了结尾——翻回日志第一个红色报错。后者是 GPU 侧问题不支持 Vulkan 1.1多数核显不行、驱动损坏或系统处于省电模式详见 docs/troubleshooting/windows.mdx。修复步骤# 1. 重装显卡驱动系统电源切到“高性能” # 2. 显卡控制面板开启“硬件加速 GPU 计划” # 3. 双显卡笔记本关闭双显卡切换或在设置里指定 GPU ID npm run dist:win验证方法重打之前先用 VulkanCapsViewer 确认 GPU 可用应用启动后看设置页 LOGS 区的实时日志文件在%APPDATA%\Upscayl\logs位置说明见 docs/troubleshooting/logs.mdx。验证标准构建命令流程与产物检查清掉旧产物后跑标准流程npm run clean npm run build npm run dist:win成功标志有三条缺一不可dist/下出现upscayl-2.15.0-win.exeNSIS 安装器和upscayl-2.15.0-win.zip便携版命名由artifactName规则决定日志尾部出现building targetnsis filedist/upscayl-2.15.0-win.exe archsx64其后不再有error双击 exe 能进入下图所示的主界面而不是秒退进阶调优与求助渠道你可以把每次改动后的验证换成npm run pack-app只出解包目录、跳过安装器打包省时一个量级你可以执行DEBUG* npx electron-builder --win打开 electron-builder 调试日志精确定位缺失文件是在哪一步没被拷进去问题仍未解决时通过设置页 LOGS → COPY LOGS 复制完整日志附带到项目 Discussions 提问并先过一遍 docs/troubleshooting/general-fixes.mdx。【免费下载链接】upscayl Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考