# uwvm

**Repository Path**: ultesoft/uwvm

## Basic Information

- **Project Name**: uwvm
- **Description**: Ultimate WebAssembly Virtual Machine
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-03-26
- **Last Updated**: 2025-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: vm, Wasm, WebAssembly, 虚拟机

## README

<div style="text-align:center">
    <img src="documents/images/logo_256x256.png" , alt="logo" />
    <h1>Ultimate WebAssembly Virtual Machine</h1>
    <a href="https://github.com/UltiELF/uwvm/actions?query=workflow%3Auwvm-build">
      <img src="https://img.shields.io/github/actions/workflow/status/UltiELF/uwvm/uwvm.yml?branch=dev&logo=linux" alt="github-ci" />
    </a>
    <a href="LICENSE.md">
        <img src="https://img.shields.io/badge/License-Apache%202.0-green.svg" , alt="License" />
    </a>
    <a href="https://zh.cppreference.com">
        <img src="https://img.shields.io/badge/language-c++23-blue.svg" ,alt="cppreference" />
    </a>
    <a
        href="http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=ZC_7qjkJTPdDT1-mjefD-a8X5V30A_ql&authKey=CJ41sGDX5Oyut4IccWrKUdsqSfbgJztM7OiJ4etn7ruTJRpYbgi%2FIrfEEJxHOZew&noverify=0&group_code=909035408">
        <img src="https://img.shields.io/badge/chat-on%20QQ-red.svg" , alt="QQ" />
    </a>
    <a
        href="https://discord.gg/xkvGy79e">
        <img src="https://img.shields.io/badge/chat-on%20Discord-7289da.svg" , alt="Discord" />
    </a>
    <a
        href="https://kook.top/L7rWIo">
        <img src="https://img.shields.io/badge/chat-on%20KOOK-6bff1d.svg" , alt="KOOK" />
    </a>
</div>

|[English](README.md)|

## 联系我们

- [Discord](https://discord.gg/xkvGy79e)
- [KOOK](https://kook.top/L7rWIo)
- QQ: [909035408](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=ZC_7qjkJTPdDT1-mjefD-a8X5V30A_ql&authKey=CJ41sGDX5Oyut4IccWrKUdsqSfbgJztM7OiJ4etn7ruTJRpYbgi%2FIrfEEJxHOZew&noverify=0&group_code=909035408)
- 仓库: [Gitee](https://gitee.com/UltiELF/uwvm), [GitCode](https://gitcode.com/MacroModel/uwvm), [GitHub](https://github.com/UltiELF/uwvm)

## 介绍
Ultimate WebAssembly 虚拟机

## 命令行使用
* 获取版本信息
```bash
$ uwvm --version
```
* 获取命令列表
```bash
$ uwvm --help
```
* 运行虚拟机
```bash
$ uwvm <param1> <param2> ... --run <file> <argv1> <argv2> ...
```
* 运行模式
```bash
--mode [objdump, int(默认), ucint]
# objdump: 查看符号表
# int: 解释器，wasm数据栈与local数据栈可扩展并带检查；内存操作检查；等等
# ucint: 部分不检查解释器，wasm数据栈大小固定不检查，通过将数据栈的最左右页设置无读写执行权限进行虚拟机安全保护；local数据栈使用线程自身栈；内存操作检查；等等；性能比解释器快1.20倍
```

* 加载 WASM ABI (默认自动检测)
```bash
--abi [bare|emscripten|wasi]
```

## 特征
### 功能扩展
| 功能                                                                                                                                               |          参数                        |
|----------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------|
| [MVP](https://github.com/WebAssembly/design/blob/main/BinaryEncoding.md)                                                                           |  V1.0.0                              |
| [JS BigInt to Wasm i64 integration](https://github.com/WebAssembly/JS-BigInt-integration)                                                          |  N/A                                 |
| [Bulk memory operations](https://github.com/WebAssembly/bulk-memory-operations/blob/master/proposals/bulk-memory-operations/Overview.md)           |  V1.0.1                              |
| [Extended constant expressions](https://github.com/WebAssembly/extended-const/blob/master/proposals/extended-const/Overview.md)                    |  :x:                                 |
| [Garbage collection](https://github.com/WebAssembly/gc)                                                                                            |  :x:                                 |
| [Multiple memories](https://github.com/WebAssembly/multi-memory/blob/master/proposals/multi-memory/Overview.md)                                    |  ```--enable-multi-memory```         |
| [Multi-value](https://github.com/WebAssembly/spec/blob/master/proposals/multi-value/Overview.md)                                                   |  V1.0.1                              |
| [Mutable globals](https://github.com/WebAssembly/mutable-global/blob/master/proposals/mutable-global/Overview.md)                                  |  V1.0.1                              |
| [Reference types](https://github.com/WebAssembly/reference-types/blob/master/proposals/reference-types/Overview.md)                                |  V1.0.1                              |
| [Relaxed SIMD](https://github.com/WebAssembly/relaxed-simd/tree/main/proposals/relaxed-simd)                                                       |  ```--enable-relaxed-simd```         |
| [Non-trapping float-to-int conversions](https://github.com/WebAssembly/spec/blob/master/proposals/nontrapping-float-to-int-conversion/Overview.md) |  V1.0.1                              |
| [Sign-extension operations](https://github.com/WebAssembly/spec/blob/master/proposals/sign-extension-ops/Overview.md)                              |  :x:                                 |
| [Fixed-width SIMD](https://github.com/WebAssembly/simd/blob/master/proposals/simd/SIMD.md)                                                         |  ```--enable-fixed-width-simd```     |
| [Extended constant expressions](https://github.com/WebAssembly/extended-const/blob/master/proposals/extended-const/Overview.md)                    |  :x:                                 |
| [Tail calls](https://github.com/WebAssembly/tail-call/blob/master/proposals/tail-call/Overview.md)                                                 |  :x:                                 |
| [Threads and atomics](https://github.com/WebAssembly/threads/blob/master/proposals/threads/Overview.md)                                            |  ```--enable-thread```               |
| [Exception handling](https://github.com/WebAssembly/exception-handling/blob/master/proposals/exception-handling/Exceptions.md)                     |  ```--enable-exception-handling```   |
| [JS Promise Integration](https://github.com/WebAssembly/js-promise-integration)                                                                    |  N/A                                 |
| [Memory64](https://github.com/WebAssembly/memory64/blob/master/proposals/memory64/Overview.md)                                                     |  ```--enable-memory64```             |
| [Custom Page Sizes](https://github.com/WebAssembly/custom-page-sizes/blob/main/proposals/custom-page-sizes/Overview.md)                            |  ```--enable-custom-page-sizes```    |
| [Type reflection](https://github.com/WebAssembly/js-types/blob/main/proposals/js-types/Overview.md)                                                |  :x:                                 |
| [Sign-extension operators](https://github.com/WebAssembly/sign-extension-ops/blob/master/proposals/sign-extension-ops/Overview.md)                 |  V1.0.1                              |
| [WASI](https://github.com/WebAssembly/WASI)                                                                                                        |  V1.0.1                              |
| [WASI Preview 2](https://github.com/WebAssembly/WASI/blob/main/preview2/README.md)                                                                 |  :x:                                 |
| [WASIX](https://wasix.org/)                                                                                                                        |  :x:                                 |

### 多平台支持
* (x86\_64, i386, aarch64, arm)-windows-(gnu, msvc) (支持UCRT和MSVCRT)
* (x86\_64, i386, aarch64, arm, loongarch64, riscv64, mips64, powerpc64, etc.)-linux-(gnu, musl, llvm, mlibc, uclibc, avrlibc, etc.)
* (x86\_64, i386, aarch64, arm)-linux-android
* (x86\_64, i386, aarch64, arm, powerpc, powerpc64, powerpc64le, powerpcspe, riscv64)-freebsd
* unknown-dragonflybsd
* unknown-netbsd
* unknown-openbsd
* unknown-bsd
* unknown-sun
* unknown-apple-darwin
* i386-msdosdjgpp
* wasm32-wasip1, wasm32-wasip2, wasm64-wasip1, wasm64-wasip2, wasm32-wasip1-threads, wasm32-wasip2-threads, wasm64-wasip1-threads, wasm64-wasip2-threads (自举)
* etc.

## 如何构建
1. 安装 [[xmake]](https://github.com/xmake-io/xmake/)
```bash
$ sudo apt install xmake
```
2. 安装 [[gcc13+]](https://github.com/gcc-mirror/gcc) 或者 [[llvm17+]](https://github.com/llvm/llvm-project)
```bash
$ sudo apt install gcc g++
```
3. 开始构建
```bash
$ xmake 
$ xmake install -o OutputPath 
```
4. 构建参数
```bash
$ xmake f -m [release|releasedbg|debug] -p [windows|mingw|linux|sun|msdosdjgpp|bsd|freebsd|dragonflybsd|netbsd|openbsd|macosx|iphoneos|watchos|wasm-wasip1|wasm-wasip2|cross ..] -a [x86_64|i386|arm|aarch64 ..] --cppstdlib=[default|libstdc++|libc++] ..
```
* 目前只支持 msvc 14.30+ ，gcc 14+ 以及 llvm 18+。
* Windows 上建议使用 llvm 或 msvc，gcc 的 libgcc 的 emults 对 tls 实现有问题导致效率变慢10倍
* Android 上编译请添加参数``` --static=n ```，安卓无法静态链接libc
* 若要编译兼容 WIN10 (默认) 以下系统，请添加参数
```bash 
--min-win32-sys=[WIN10|WINBLUE|WIN8|WIN7|WS08|VISTA|WS03|WINXP|WIN2K]
```
* 对于WIN9X (i386-windows-gnu)
```bash
--min-win32-sys=[WINME|WIN98|WIN95]
```
* 使用llvm工具链 (部分使用 gcc 软连接 clang 的平台必须加上这个选项，比如 macos 与 android )
```bash 
--use-llvm=y|n(default)
```
* 使用ucint (同时会自动禁用c++异常)
```bash 
--uwvm-enable-ucint=y|n(default)
```
* 编译使用本地指令集
```bash 
--native=y|n(default)
```
* 选择工具链
```bash 
--sdk=ToolchainPath
```
* 静态链接
```bash
--static=y(default)|n
```
* 设置 sysroot
```bash
--sysroot=<path>
```
* 记录每一步消耗的时间
```bash 
--timer=y|n(default)
```
* 使用mimalloc作为默认分配器
```bash 
--use-mimalloc=y|n(default)
```
* 禁用c++异常（会导致部分WASI用不了）
```bash
--fno-exceptions=y|n(default)
```
* 启用清洁器
```bash
--policies=build.sanitizer.address --policies=build.sanitizer.leak
```