Electron应用白屏主因是加载方式错误或安全配置不当：loadFile()适用于开发期路径解析，loadURL()需绝对路径易出错；禁用nodeIntegration、启用contextIsolation并配合preload脚本桥接API才是安全实践。
直接用 HTML 文件就能启动 Electron 桌面应用，但必须配合正确的主进程控制逻辑和加载方式，否则会白屏、报错或无法访问 Node.js API。
BrowserWindow.loadFile() 和 loadURL() 的区别与选型
渲染进程的 HTML 页面必须通过 BrowserWindow 实例加载，但加载方式直接影响安全性、路径解析和本地资源访问能力。
-
loadFile('index.html')：推荐用于开发期，自动处理相对路径（如./css/style.css），且不触发跨域限制；但要求 HTML 文件在项目目录内，且路径是相对于main.js所在目录的 -
loadURL('file:///path/to/index.html')：需手动拼接绝对路径，容易出错；在 Windows 上反斜杠转义易引发问题；打包后路径可能失效 - 绝对不用
loadURL('http://localhost:3000')做开发——这会让渲染进程变成普通网页环境，nodeIntegration默认关闭，IPC 通信也受限
HTML 页面里如何安全调用 Node.js 或 Electron API
默认情况下，渲染进程无法直接使用 require 或 electron 模块，这是 Chromium 的安全策略。绕过它不是“去掉限制”，而是按设计接入。
- 不要设
nodeIntegration: true—— 这等于打开远程代码执行漏洞，2026 年主流 Electron 版本已默认禁用 - 正确做法是启用
contextIsolation: true（必须），再通过preload脚本桥接有限能力 - 例如，在
preload.js中暴露一个安全封装的函数：window.api = { saveFile: (data) => ipcRenderer.invoke('save-file', data) } - HTML 中直接调用
window.api.saveFile(...)，主进程用ipcMain.handle('save-file', ...)处理
HTML 页面白屏、控制台报错“Failed to load resource”怎么办
90% 是路径或协议问题，不是代码写错了。
立即学习“前端免费学习笔记（深入）”；
- 检查
main.js中loadFile()的路径是否真的存在，比如path.join(__dirname, '../index.html')—— 如果main.js在electron/main.js，那../index.html才对，而不是./index.html - HTML 里引用的 JS/CSS 用相对路径即可（
src="js/app.js"），但确保这些文件跟 HTML 在同一级或子目录，且没被 Webpack/Vite 等构建工具意外排除 - 如果用了
file://协议加载却提示 CORS，说明你误用了loadURL且没配webSecurity: false（不建议） - 打开开发者工具（
win.webContents.openDevTools()）看 Network 面板，确认 HTML 和资源状态码是不是 200
打包后 HTML 页面找不到 assets 怎么办
electron-builder 或 electron-packager 默认只拷贝 package.json 同级目录下的文件，子目录或深层路径需要显式声明。
- 如果你的 HTML 在
src/index.html，CSS 在src/css/main.css，那打包时必须在build.files中写清楚：["src/**/*", "package.json"] - 避免在 HTML 中写死
../../assets/logo.png—— 改用根相对路径/assets/logo.png，并在BrowserWindow创建时加webPreferences: { webSecurity: false }（仅限调试）或改用protocol.registerFileProtocol注册自定义协议 - 更稳妥的做法：把所有静态资源放在
app.getAppPath()可达的路径下，用path.join(app.getAppPath(), 'assets', 'icon.png')动态生成 URL
最常被忽略的是 preload 脚本的加载时机和上下文隔离边界——它既不能访问渲染进程的 window 全局，也不能直接暴露原始 IPC 对象，中间那层代理逻辑写错一字符，整个通信就静默失败。
