Vite 默认不直接处理 .wasm 文件加载，需启用 experimental.wasm 或配置插件；推荐将 WASM 放入 public/ 并用 WebAssembly.instantiateStreaming + fetch 加载，注意 MIME 类型与部署路径一致性。
Vite 对 WASM 的支持依赖于底层构建工具（如 esbuild 或 rollup）以及浏览器原生能力，但默认不直接处理 .wasm 文件的加载逻辑。要让 WASM 模块在 Vite 项目中正确加载，关键在于：**正确导入、避免被当作普通资源处理、适配模块初始化方式（尤其是带 `instantiateStreaming` 的异步加载）**。
确保 WASM 文件被识别为模块而非静态资源
Vite 默认会把 .wasm 文件当作静态资源（输出到 assets/），直接 import 会导致解析失败或返回 URL 字符串而非可执行模块。需通过配置启用 WASM 模块支持：
- 在
vite.config.ts中启用experimental.wasm（Vite ≥ 5.0）：export default defineConfig({<br> experimental: { wasm: true },<br> // 其他配置...<br>}) - 若使用较老版本（Vite 4.x），需手动配置
resolve.extensions并配合插件（如vite-plugin-wasm）或改用import.meta.glob+WebAssembly.instantiateStreaming手动加载。
用标准 WebAssembly 动态加载方式替代直接 import
不要写 import init, { add } from './add.wasm'（ES module syntax for WASM 尚未被所有构建工具稳定支持）。推荐使用浏览器原生的流式实例化：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 将 WASM 文件放在
public/下（如public/add.wasm），然后在代码中： const wasmModule = await WebAssembly.instantiateStreaming(<br> fetch('/add.wasm')<br>);<br>console.log(wasmModule.instance.exports.add(2, 3)); // → 5- 注意：该方式要求服务器支持
Content-Type: application/wasm（Vite 开发服务器默认支持；生产环境需确保 Nginx/Apache 等已配置 MIME 类型）。
使用 @rollup/plugin-wasm 或 vite-plugin-wasm（进阶场景）
若需在 JS 中直接 import WASM 并自动初始化（例如 Rust/C 编译出的带 JS 胶水代码的包），可引入对应插件：
立即学习“Java免费学习笔记（深入）”；
- 安装：
npm install --save-dev @rollup/plugin-wasm vite-plugin-wasm - 配置插件（Vite 5+ 可选）：
import wasm from '@rollup/plugin-wasm';<br>// vite.config.ts<br>export default defineConfig({<br> plugins: [wasm()],<br> resolve: { extensions: ['.js', '.ts', '.wasm'] }<br>}) - 此时可写：
import init, { add } from './pkg/my_wasm_module.js';（前提是该 JS 是wasm-pack或类似工具生成的标准胶水代码）。
注意开发与生产环境的一致性
Vite 开发服务器对 WASM 流式加载支持良好，但生产构建后路径可能变化：
- 用
fetch('/xxx.wasm')时，确保路径相对于站点根目录（base: '/'）；若部署子路径（如/my-app/），需设base: '/my-app/'并用new URL('./xxx.wasm', import.meta.url)构造相对路径。 - 检查浏览器控制台是否报错
TypeError: Failed to execute 'instantiateStreaming' on 'WebAssembly': Incorrect response MIME type——这说明服务器没返回application/wasm，需修正服务端配置。
