HTML转EXE本质是封装网页与浏览器内核，非编译；Electron需用loadFile+绝对路径且资源用相对路径，WebView2须等待CoreWebView2初始化完成，Tauri复用系统WebView更轻量，PyInstaller+Flask则打包HTTP服务。
HTML 转 EXE 不是编译，而是把网页和一个浏览器内核“装进同一个盒子”里运行；选错方案会导致图片不显示、启动失败、体积爆炸，甚至被杀软误报。
Electron 打包后图片全白？检查 loadFile 和路径拼接
Electron 默认用 loadFile 加载本地 HTML 时，路径必须是绝对路径，且资源引用需为相对路径。若用 loadURL('file://' + __dirname + '/index.html')，__dirname 在打包后会指向临时解压目录，但图片仍按原始项目结构查找——结果就是控制台报 Not allowed to load local resource。
- 改用
loadFile(path.join(__dirname, 'index.html'))（需require('path')） -
index.html中所有<img src="img/logo.png">必须保持相对路径，不能写成src="./img/logo.png"或绝对路径 - 打包工具如
electron-builder默认不拷贝img/目录，需在build.files中显式包含
WebView2（C#）加载本地 HTML 失败？别跳过 EnsureCoreWebView2Async
在 Windows 上用 C# + WebView2 打包，常见错误是直接调用 Navigate("index.html") 而没等内核初始化完成，导致页面空白或白屏。这不是路径问题，是异步时机问题。
- 必须在
WebView2.CoreWebView2InitializationCompleted事件触发后，或 awaitEnsureCoreWebView2Async()完成后再导航 -
Navigate参数不能是相对路径，得是完整 file:// URL：用Path.Combine(Application.StartupPath, "index.html")拼出路径，再转file://格式（注意三斜杠：file:///C:/...） - 图片路径仍需相对，且确保 HTML 文件和
img/同级——WebView2 不会自动解析 base href 或处理重定向
想轻量又跨平台？Tauri 比 Electron 少写 90% 的配置
Tauri 不打包 Chromium，而是复用系统 WebView（Windows 用 WebView2），所以生成的 EXE 通常不到 10MB，启动快，但对旧系统有要求：Windows 10 1803+、macOS 10.15+。
立即学习“前端免费学习笔记（深入）”；
- 初始化比 Electron 简单：
tauri build自动处理资源打包，src-tauri/icons放图标，dist/放 HTML/CSS/JS 即可 - 图片路径照常写相对路径，Tauri 内部自动映射到
file://或tauri://协议，无安全拦截 - 不支持 Node.js API，要调用文件系统得用 Tauri 的
fs或pathAPI，前端需加invoke调用
PyInstaller + Flask 方案：适合纯展示、不想带浏览器内核的场景
这个方案本质是“打包一个微型 HTTP 服务”，运行 EXE 后自动打开浏览器访问 http://localhost:5000。它不嵌入浏览器，因此没有 file:// 安全限制，但多了一层网络依赖。
- Flask 静态文件必须用
send_from_directory，不能靠url_for('static', ...)—— 因为静态目录在打包后不存在于文件系统中 - PyInstaller 的
--add-data要把整个templates/和static/打进去，代码里用sys._MEIPASS定位真实路径 - 端口被占用时会卡住，建议加
port = find_free_port()逻辑，避免用户双击无响应
真正麻烦的不是打包动作本身，而是资源路径在不同环境下的“语义漂移”：开发时 ./img/ 是对的，打包后可能变成 app.asar/img/ 或 C:\Users\...\temp\img\。盯住那个路径变量，比学十种工具更重要。
