HTML如何用Tauri打包构建轻量桌面应用

本文深入解析了使用Tauri将HTML前端打包为轻量级桌面应用时最常遇到的四大核心问题：无法生成可执行文件、index.html路径错配导致白屏、本地资源加载被拦截，以及allowlist权限配置失效；文章不仅指出根本原因——Tauri并非纯前端工具，而是依赖Rust后端协同的双层架构，强调项目必须包含Cargo.toml和src-tauri目录、正确配置distDir与tauri://协议、显式声明细粒度API权限，并给出Windows构建必备VS Build Tools、Vite输出路径对齐、安全调用窗口/剪贴板等实操方案，帮助开发者避开Electron式思维陷阱，真正掌握Tauri“默认安全、显式授权、前后端紧耦合”的设计哲学。

tauri build 为什么打包不出可执行文件

直接运行 tauri build 却没生成 target/release 下的 .exe 或 .app，大概率是项目还没真正“接入 Tauri”——它不是纯前端构建工具，必须和 Rust 后端共存。你当前目录下如果没有 Cargo.toml、没有 src-tauri 文件夹，那 tauri build 就只是个空转的命令。

实操建议：

• 确认已用 npm create tauri-app@latest 初始化（别手动 npm init + 手动加依赖）
• 检查是否存在 src-tauri/tauri.conf.json；没有这个文件，tauri build 会静默失败
• Windows 用户注意：必须安装 Visual Studio Build Tools（含 Windows SDK），仅装 VS Code 不行
• 如果之前跑过 tauri dev 成功，但 build 失败，先删掉 target 和 src-tauri/target 再试

index.html 路径不对导致白屏

Tauri 默认加载的是 src-tauri/tauri.conf.json 里 build.distDir 指向的路径下的 index.html，不是你前端项目根目录下的那个。很多人把 Vite 打包完的 dist/index.html 忘了同步过去，或者改了 distDir 却没更新构建脚本，结果双击程序只看到空白窗口。

实操建议：

• tauri.conf.json 中的 build.distDir 默认是 ../dist，意味着它期望上层目录有个 dist 文件夹
• Vite 用户应在 vite.config.ts 中设 build.outDir: '../dist'，而不是默认的 dist
• 改完配置后，必须重新运行 npm run build（生成 HTML/CSS/JS），再运行 tauri build（打包二进制）
• 开发时可用 tauri dev 自动代理，但上线前务必验证 distDir 和实际文件位置是否匹配

window.open 和 iframe 加载本地资源被拦截

Tauri 默认禁用 file:// 协议加载，所有 HTML、JS、CSS 必须通过 tauri:// 协议访问。直接写