You need to enable JavaScript to run this app. 如何解决NeutralinoJS应用运行时出现白屏的问题?
优惠活动
大模型
产品
解决方案
定价
更多

如何解决NeutralinoJS应用运行时出现白屏的问题?

NeutralinoJS 执行neu run白屏问题解决方案
  • 第一步:校验入口配置正确性
    打开项目根目录下的neutralino.config.json文件,确认documentPath字段指向的入口HTML文件路径正确,默认空白项目该配置应为/resources/index.html,路径拼写错误、目标HTML文件不存在都会直接触发白屏。
  • 第二步:确认前端资源状态
    如果是对接Vue、React等前端框架的项目,需要先执行对应框架的构建命令,将打包后的产物输出到配置指定的resources目录下,再执行neu run,未构建就直接启动会找不到前端资源导致白屏。
  • 第三步:开启调试模式定位报错
    执行neu run --debug命令启动应用,启动后会自动打开Chromium开发者工具,可通过控制台面板查看JS报错、网络面板查看资源加载失败信息,直接定位具体问题。
  • 第四步:校验WebView2运行时状态
    NeutralinoJS依赖系统Edge WebView2运行时渲染页面,若本地未安装或运行时版本过低也会出现白屏问题,你执行的CheckNetIsolation.exe命令仅用于解决WebView2的网络隔离问题,大部分白屏故障和该配置无关。
  • 第五步:清理缓存重试
    先终止所有Neutralino相关进程,删除项目根目录下的.neu缓存文件夹后重新执行neu run,旧缓存文件损坏也可能导致资源加载异常。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.13 04:36:03