C

写得像桌面 C#，入口固定是一个叫 P 的类。

在手机上怎么跑

vml run examples/csharp/test/sysinfo.cs

编译要等一会儿（C 那种要一两分钟，脚本类语言几秒）。程序跑起来后屏幕底部就是手柄，方向键 + 四个动作键都在；点右上角返回可以回到命令行。

写法要点

• 入口是 class P { static void Main() }
• System.Console.WriteLine 能直接用
• 状态放 static 字段或数组里

示例

同目录还有：app/breakout.cs、app/g2048.cs、demo/demo_std.cs、test/libs.cs、tty/demo_tty.cs、ui/demo_ui.cs

下面的内容是从 VML 源码里直接带的（third_party/vml/VMLPrepares/CSharpCompiler/）： README 讲这个前端支持什么、怎么编；语言规范 讲语法本身。上游一改，这里重新生成就是最新的。

语言规范

C# 语言编译器规范说明

版本：v1.0 | 日期：2026-07-06 | 修订者：深圳市探索智能科技有限公司

规范标准

关键字

abstract as base bool break byte case catch char checked class const continue decimal default delegate do double else enum event explicit extern false finally fixed float for foreach goto if implicit in int interface internal is lock long namespace new null object operator out override params private protected public readonly ref return sbyte sealed short sizeof stackalloc static string struct switch this throw true try typeof uint ulong unchecked unsafe ushort using virtual void volatile while

概述

支持 C# 语言子集，编译为 VML 汇编代码。采用静态编译版架构。文档描述的目标特性含 C# 2.0~5.0+ 语法（LINQ/async/await/switch表达式等），实际实现以基本语法为主，高级特性待实现。

支持的语言特性

1. 数据类型

• 基本类型: int, double, float, bool, string, char, decimal
• 引用类型: object, 类, 接口, 数组, 委托
• 值类型: 结构体, 枚举
• 泛型: List<T>, Dictionary<K,V>

2. 变量和常量

int number = 10;
const double PI = 3.14159;
string text = "Hello";
var inferred = 42;  // 类型推断
int? nullable = null; // 可空类型

3. 控制流

// if-else
if (condition) {
    Console.WriteLine("true");
} else {
    Console.WriteLine("false");
}

// switch表达式
string result = value switch {
    1 => "One",
    2 => "Two",
    _ => "Other"
};

// 循环
for (int i = 0; i < 10; i++) { }
foreach (var item in collection) { }
while (condition) { }
do { } while (condition);

4. 方法和属性

public int Add(int a, int b) {
    return a + b;
}

// 属性
public string Name {
    get => _name;
    set => _name = value;
}

// 自动属性
public int Age { get; set; }

// Lambda表达式
Func<int, int> square = x => x * x;

5. 类和接口

public class Person {
    public string Name { get; set; }
    public int Age { get; set; }
    
    public Person(string name, int age) {
        Name = name;
        Age = age;
    }
    
    public virtual void Introduce() {
        Console.WriteLine($"I'm {Name}, {Age} years old");
    }
}

public interface IDrawable {
    void Draw();
}

6. 异常处理

try {
    int result = Divide(10, 0);
} catch (DivideByZeroException ex) {
    Console.WriteLine($"除零错误: {ex.Message}");
} catch (Exception ex) {
    Console.WriteLine($"其他错误: {ex.Message}");
} finally {
    Console.WriteLine("清理资源");
}

// 自定义异常
public class CustomException : Exception {
    public int ErrorCode { get; }
    
    public CustomException(string message, int errorCode) 
        : base(message) {
        ErrorCode = errorCode;
    }
}

7. LINQ和集合

var numbers = new List<int> { 1, 2, 3, 4, 5 };
var evenNumbers = numbers.Where(n => n % 2 == 0);
var doubled = numbers.Select(n => n * 2);
var sum = numbers.Sum();
var average = numbers.Average();

// 字典
var dict = new Dictionary<string, int> {
    ["apple"] = 1,
    ["banana"] = 2
};

8. 异步编程

public async Task<string> FetchDataAsync() {
    using var client = new HttpClient();
    return await client.GetStringAsync("https://api.example.com");
}

// 使用async/await
async Task ProcessData() {
    try {
        string data = await FetchDataAsync();
        Console.WriteLine(data);
    } catch (HttpRequestException ex) {
        Console.WriteLine($"网络错误: {ex.Message}");
    }
}

浮点与64位编译模式

VML 工具链通过三个编译参数控制浮点和 64 位整数的处理策略：

32位浮点 (float32)

本语言中的 32 位单精度浮点类型 float 按以下模式编译：

• hard 模式（默认）: 使用 VML 原生浮点指令 MOVEF/ADDF/SUBF/MULF/DIVF/CMPF/NEGF，通过 F0-F15 十六个浮点寄存器直接运算。性能最佳，适合支持浮点硬件的目标平台。
• soft 模式: 使用 Q15.16 定点数软件模拟库 softfloat.c，通过 __vml_float_add/sub/mul/div/neg/abs/cmp 等函数模拟浮点运算。适合无浮点硬件的 MCU 平台。
• none 模式: 禁用所有 32 位浮点类型，遇到 float 声明时报告编译错误。

64位浮点 (double)

本语言中的 64 位双精度浮点类型 double 按以下模式编译：

• soft 模式（默认）: 使用 IEEE 754 双精度软件模拟库 softdouble.c，通过 __vml_double_add/sub/mul/div/neg/abs/cmp、__vml_int2double/double2int、__vml_float2double/double2float 等函数模拟。兼容所有平台（含 MCU）。
• hard 模式: 使用 VML 双精度指令 MOVED/ADDD/SUBD/MULD/DIVD/CMPD/NEGD，通过 D0-D7 八个双精度寄存器运算。需要目标平台支持 64 位运算。
• none 模式: 禁用所有 64 位浮点类型，遇到 double 声明时报告编译错误。

64位整数 (int64)

本语言中的 64 位整数类型 long / ulong 按以下模式编译：

• soft 模式（默认）: 使用双寄存器软件模拟库 softint64.c，通过 __vml_i64_add/sub/neg/and/or/xor/not/shl/shr 等函数模拟 64 位整数运算。
• hard 模式: 预留，未来 VML 版本将支持原生 64 位整数指令。
• none 模式: 禁用 64 位整数类型，遇到 long / ulong 声明时报告编译错误。

软件模拟库

以上软件模拟库均位于 Lib/shared/ 目录，使用 C 语言编写并由 C 编译器编译为 VML，所有语言共享：

编译器状态

• 完成度: ~92%
• 标准库: Lib/csharp/ (C# 标准库，待创建)
• Lexer: 内嵌于 CSharpCompiler.cs
• Parser: Parser.cs
• CodeGenerator: CodeGenerator.cs

编译使用

dotnet run --project VMLTool -- input.cs -o output.vml
# 或插件模式:
vmltool input.cs -o output.vml

🆕 字符串类型 (v1.65.19)

该语言编译器默认使用 .wstring (UTF-16LE) 作为内部字符串存储。

预定义宏: VML_WSTRING — OS 模式下自动定义，MCU 模式未定义 输出函数: OS 模式自动使用 shared_print_wstr (UTF-16LE→UTF-8 自动转换)

// 用户代码可通过宏判断编码
#ifdef VML_WSTRING
  // 默认字符串为 wstring (UTF-16LE)
#else
  // 默认字符串为 UTF-8
#endif

编译器 README

C# 编译器

路径: VMLPrepares/CSharpCompiler/ 完成度: ~92% | 🟢 生产可用 标准库: Lib/csharp/（待创建）

功能

• ✅ 完整语法分析 + 代码生成
• ✅ 控制流 (if/while/for/switch)
• ✅ 函数/过程定义和调用
• ✅ 标准库支持
• ✅ POKE/PEEK 内存操作 (MMIO)
• ✅ 十六进制字面量
• ✅ 共享内置函数库 (builtins.vml)

编译模式

MCU 模式（默认 --mode mcu）

MCU 模式针对单片机/裸机环境（Arduino/STM32/8051 等）优化，自动跳过不兼容操作系统的特性。

跳过（遇到这些语法不生成代码）:

• async/await、Task、GC、reflection

保留（由 BIOS 实现底层）:

• new(堆)、class、属性
• POKE/PEEK 内存映射 I/O (MMIO)
• 基本类型运算、控制流、函数调用
• printf/puts 映射到 UART
• LINQ/泛型 — 待实现

OS 模式（--mode os，预留）

OS 模式针对带操作系统环境（如 Linux 嵌入式、RTOS 等），届时支持全部语言特性（文件系统、多线程、异步、异常、反射等）。

RAM 级别

• --ram k：KB级别（2KB~64KB，如 8051/PIC/AVR）
• --ram m：MB级别（64KB~1MB，如 ARM Cortex-M，默认）
• --ram g：GB级别（如 x86/DDR 系统）
• --stack-size <bytes>：手动指定栈大小（默认自动根据 --ram 分配）

MCU 安全编码提示

• 有限栈空间（256-4096 字节典型），避免深度递归
• 禁止深度递归（>10层需评估栈）
• 禁止动态加载（import/dofile/eval）
• 浮点运算可能需软浮点库

使用

dotnet run --project VMLPrepares/CSharpCompiler input.CS -o output.vml

测试

Test/CS/ — 0 测试文件（测试目录待创建）