NiHao

A new better C language for my fantasy， a better programing world for void !

一个新的 "better C" 语言，给void一个更好的编程世界!

"Empty your mind, be formless, shapeless, like water. You put water into a cup, it becomes the cup; you put it into a bottle, it becomes the bottle; you put it into a teapot, it becomes the teapot. Now water can flow, or it can crash. Be water, my friend." — Bruce Lee

"清空你的思绪，无形无相，如水一般。

水入杯，则成杯形；入瓶，则成瓶形；入茶壶，则成茶壶之形。

水可缓缓流淌，亦可奔涌冲击。

像水一样吧，我的朋友。"

— 李小龙

语法文档|Document

中文 | English

开发约定|Development Conventions

Git 提交与推送约定 · 版本路线图（1.0/2.0） · 阶段总结（历史快照） · TODO · 变更日志

Source code example demonstration:

源码展示:

module main
use stdio

// 命名类型：struct（含位域字段）
Packet struct {
    type u8
    len u8:4
    flag u8:4
}

const MaxLen i8 = 100

func main()
{
    puts("Program starting")

    // 数组与浮点运算
    arry f32[3] = {1.1, 1.2, 1.3}
    sum f64 = arry[0] + arry[1] + arry[2]
    if sum > 3.0 {
        puts("array ok")
    }

    // 结构体成员访问
    p Packet
    p.type = 1
    p.len = MaxLen
    p.flag = 1

    // 可见性检查（编译期查询）
    if visof(MaxLen) == _const {
        puts("MaxLen is _const")
    }

    return
}

说明：上例为当前全量（A 方案）后端可编译的语法。更多特性示例见 docs/Chinese.md：多返回值（命名 struct 返回）、编译期 cooking/static_assert、指针 .() 解引用、flow/static/const 存储期与所有权、 函数指针等（部分为 BNF 规划特性，实现进度见 TODO.md）。

语言设计规范（完整 BNF）：docs/BNF.md。

安装 | Installation

1. 安装 xmake

构建依赖 xmake（唯一构建入口，Makefile 已标为 legacy）：

# Windows（powershell）
winget install xmake

# Linux / macOS
curl -fsSL https://xmake.io/shget.text | bash

2. 安装 tcc（编译器后端依赖）

NihaoC 1.0 的 c / native 后端依赖 TinyCC（tcc 负责把生成的 C 编译为机器码）：

• Windows：将 tcc 解压到任意目录（如 C:\dev\tcc），设置环境变量 NIHAO_TCC_DIR=C:\dev\tcc；未设置时从 PATH 探测。MSYS 路径（/d/devtools/tcc）会自动归一化
• Linux：sudo apt install tcc（或 pacman -S tcc），-run 内存执行与 libtcc.so 均可用
• 验证：tcc -v 能看到版本号即可

构建与运行 | Build & Run

编译器源码位于 ncc/，构建统一使用 xmake：

cd ncc
xmake                          # 构建 nihao 可执行文件
xmake test                     # 默认 c 后端回归测试
xmake test -b native           # native 后端回归测试
xmake test --all               # 四后端全矩阵（c / native / ir-c / ir-native）

CLI 命令 | Commands

nihao <command> [options]

命令	作用
init [name]	创建新项目（nihao.toml + src/main.nc）
build <file>	编译为可执行文件（保留 <out>.c 中间产物）
run <file>	编译并运行；-- 之后的参数透传给 main(argc, argv)
debug <file>	编译并输出详细信息后运行；--ir 打印 IR 三地址码（2.0 预览）
test	运行回归测试套件（tests/）
lex <file>	打印源文件的 token 流

常用选项：-o <file> 输出名 · -backend c|native 选择后端 · -run（Linux only）内存执行 · -g 调试信息 · -I/-L/-l 头文件/库路径与链接 · --link <lib> as <alias> 链接别名。

后端 | Backends

后端	范围	说明
c（默认）	1.0 正式支持	生成 C 文本，调用外部 tcc 编译为可执行文件
native	1.0 正式支持	libtcc 进程内编译生成的 C 为机器码（无需外部 tcc）
ir-c / ir-native	2.0 预览	IR 中间层：→C 文本 / →x86-64 汇编（Windows x64 ABI）
ir-riscv64	2.0 预览	IR → RISC-V 64 汇编（RV64I + D 浮点扩展，验汇编生成）
ir-arm64	2.0 预览	IR → AArch64 汇编（AAPCS64，验汇编生成）
ir-loongarch64	2.0 预览	IR → LoongArch64 汇编（LA64 基础指令集，验汇编生成）

1.0 范围：c / native 两后端为对外可用产品线（路线图 A 方案），v1.0.2 门禁实测：全量语法回归每后端 38 PASS / 0 FAIL / 5 SKIP，examples 6/7 —— 06_cooking.nc 为 2.0 预览示例（cooking 编译期块与编译期函数尚未纳入 1.0 语法），1.0 线两后端不接受、ir-c / ir-native 可通过。 计数随版本变化，权威口径以 CHANGELOG.md 当前版本段与 docs/IMPLEMENTATION_STATUS.md 为准。 双平台验证（2026-08-31，v1.0.0 时点）：Windows 与 Linux（WSL Ubuntu-24.04）均通过 c/native 全量回归 0 FAIL + examples 6/6（c/native 双后端，当时的用例集）；-run 内存执行在 Linux 实测通过（WSL 期间修复 4 个平台 bug， 详见 CHANGELOG v1.0.1 记录）。 2.0 预览：ir-* 四架构后端（x86-64/riscv64/arm64/loongarch64）为下一代演进线（路线图 B 方案）， 其中 riscv64/arm64/loongarch64 生成标准 GAS 汇编（-backend=ir-riscv64 -o out.s），本机无交叉 汇编器，仅验证汇编生成正确性。版本规划详见 docs/VERSIONING_ROADMAP.md。

TCC 安装目录通过 NIHAO_TCC_DIR 环境变量指定（如 /d/devtools/tcc，MSYS 路径自动归一化），否则从 PATH 探测。

-run 内存执行（Linux only）

-run 将程序编译到内存并直接执行，仅 Linux 可用：

nihao build src/main.nc -run -- arg1 arg2    # Linux

• 原因：libtcc 0.9.27 的 Windows 版 TCC_OUTPUT_MEMORY 存在缺陷（relocate 失败，错误码 251）
• Windows 下使用 -run 会得到明确报错；请改用 -backend=native -o out.exe 输出文件模式
• 能力检测由 native_memory_available() 完成（Windows 返回 0，其余平台返回 1）
• 程序参数在 -run 之后直接透传给 main(argc, argv)（PA-6）