Tauri build 不生成可执行文件是因为项目未正确接入 Tauri，需确保存在 Cargo.toml 和 src-tauri 文件夹，并安装 Visual Studio Build Tools；distDir 路径、allowlist 权限及资源协议（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:// 协议访问。直接写 <iframe src="help.html"> 或 window.open('report.html') 会触发 CORS 或协议不匹配错误，控制台报 net::ERR_UNKNOWN_URL_SCHEME 或空白内容。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 静态资源统一用相对路径：
<iframe src="./help.html">（前提是 help.html 在distDir目录内） - 需要动态打开新窗口？用
tauri::api::window::WindowBuilder（Rust 端）或@tauri-apps/api/window（JS 端）创建受控窗口 - 避免在 HTML 里硬编码
file://、http://localhost，Tauri 不支持这些协议作为主页面来源 - 图片、字体等资源同样适用相对路径；如需读取用户选择的文件，走
@tauri-apps/api/fs，而非直接src="file://..."
tauri.conf.json 的 allowlist 配置不生效
想调用系统对话框或复制剪贴板，却提示 API not allowed，常见原因是 tauri.conf.json 里开了 allowlist 总开关，但没具体开对应 API 的子项。比如只写了 "all": true，但没在 clipboard 或 dialog 下设 "all": true，照样被拦。
实操建议：
立即学习“前端免费学习笔记（深入）”；
-
allowlist是逐层开关：顶层"all": true不代表所有子功能自动开启 - 需要弹窗？确保
dialog.all和window.all都为true - 复制文本？开
clipboard.writeText（注意不是clipboard.all，细粒度控制更安全） - 改完配置必须重新
tauri build，tauri dev不读取 allowlist 变更 - 生产环境强烈建议关闭
shell.open、fs.allowlist等高危 API，除非真有需要
最常被忽略的一点：tauri 的权限模型是“显式声明”，不是“默认开放”。哪怕只调用一次 dialog.message，也得在配置里给 dialog 开口子——这和 Electron 的自由模式完全不同，跨过去的第一道坎就是习惯。
