🎓
零基础教程 (13 章)
从安装与第一个程序讲到函数、数组、字符串、struct、模块、调试与六个综合项目, 每段代码都实机验证过输出。
Code CIN简洁的类 C 语言与原生运行时
CIN / PL / ASM 工具链 · .sdgcc 编译产物 · Go 原生引擎整程序执行 · cincc 直出机器码
Skip to content
一条命令安装
bash
pip install codecin
codecin --version # 打印当前版本
codecin --help # 完整命令行帮助Go 原生引擎库是运行必需组件: pip 安装时会用本机的 Go 工具链现场编译原生库; 本机没有工具链时可从 Release 下载预编译库, 或在源码树
codecin/native/下执行build.ps1(Windows) /build.sh(Linux/Termux/macOS) 重建 (需 Go 1.26+)。 原生库缺失时运行程序会直接抛CPUSimulatorError, 没有解释器回退。 详见 安装 Code CIN。
同一段程序, 三种写法
cin
function main() -> int {
println("Hello, Code CIN!")
return 0
}默认路径下, 三种写法最终都编译成 .sdgcc 产物 (内部 CODE 段与 BIN v3 逐字节一致), 由 Go 原生引擎通过 ABI v2 一次调用执行整程序:
bash
codecin hello.cinv7.22.10 起还可走 cincc 原生机器码主线 (不经 C、不经 UCBC 字节码):
bash
codecin hello.cin --native # 编译并运行 (x86-64 ELF; Windows 自动经 WSL)
codecin hello.cin --native-out hi # 只产出二进制文档地图
| 章节 | 内容 | 入口 |
|---|---|---|
| 初学者教程 | 13 章零基础教程: 从第一个程序到函数/数组/字符串/struct/模块/调试/六个实战项目, 附习题答案与速查表 | 教程导览 · 速查表 |
| 指南 | 安装、快速开始、命令行、执行路径、架构、示例、FAQ | 安装 · 快速开始 |
| CIN 语言 | 词法、类型、变量、运算符、控制流、函数、struct、数组、字符串、内建、宿主能力、模块 | 语言总览 |
| 汇编 / ISA | 汇编语法 (ASM 与 PL 两种风格)、112 条指令语义、指令编码表 | 汇编总览 |
| 标准库 | 41 个内置库的逐函数参考 | 标准库总览 |
| 运行时 | Go 原生运行时、执行路径、.sdgcc/.bin/.crom 格式、AOT 与 cincc 原生产物 | Go 原生运行时 |
| 工具 | 日志与错误输出、性能分析、内存与运行时开关 | 日志与错误输出 |
| 参考 | 指令编码表、寄存器与内存模型、Python 嵌入 API、更新日志 | 寄存器与内存模型 |
| 开发者 | 项目结构、编译原生库、测试与 CI、打包发布、扩展指令、贡献指南 | 项目结构 |
项目信息
| 项目 | 信息 |
|---|---|
| 当前版本 | 7.22.10 (以 codecin --version 为准) |
| 编译主线 | 默认 Python 前端 → .sdgcc → Go 原生引擎; --native → Go 编译器 cincc → 目标机器码 |
| 语言实现 | Go 侧是核心 (CIN 编译器 / 字节码 VM / CROM / AOT / cincc), 用户命令行入口仍是 Python codecin |
| 唯一命令行入口 | codecin <程序> [选项] 或安装后的 codecin <程序> [选项] |
| 依赖 | Python 3.8+ 与 rich (唯一第三方运行时依赖); Go 1.26+ 仅用于编译原生库/AOT |
| 代码仓库 | ByUsiStudio/Code-CIN |
| 文档仓库 | ByUsiStudio/Code-CIN-Docs (本站在 docs/ 下, 以 git submodule 方式内嵌于主仓库) |
| 开发组织 | ByUsi Studio · 开发者: 北啊呢 · [email protected] |