# cclua
**Repository Path**: yezc/cclua
## Basic Information
- **Project Name**: cclua
- **Description**: 移植lua工具源码,支持跨平台编译。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: single_file
- **Homepage**: https://www.lua.org/
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-06
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Lua 5.5 - 单文件跨平台编译
Lua 5.5 以 **仅三个文件** 的形式分发 —— `lua.c` + `luac.c` + `lua.h` —— 在 **Windows、Linux 和 macOS** 上编译为两个二进制文件。
无需依赖、无需 configure、无需多文件混乱。直接编译即可使用。
## 快速开始
### Windows
```bat
lua_single_build.bat
```
### Linux / macOS
```sh
./lua_single_build.sh
```
编译器自动检测(gcc / clang)。
## 为什么用单文件?
原始的 Lua 源码树包含几十个源文件和头文件。
本项目将所有 Lua 源码文件合并为三个文件:
| 文件 | 说明 |
|------|------|
| `lua.h` | 合并的头文件(所有 Lua 头文件合并) |
| `lua.c` | 合并的解释器源码(所有核心 + 库 + lua.c) |
| `luac.c` | 合并的编译器源码(所有核心 + 库 + luac.c) |
两个平台通过合并源码中的 `#ifdef __linux__` / `#ifdef __APPLE__` / `#ifdef _WIN32` 条件编译来处理。
## 使用方法
### 编译脚本选项
```
lua_single_build.bat [-cc 编译器] [-m32|-m64] [-h]
lua_single_build.sh [-cc 编译器] [-m32|-m64] [-h]
```
| 选项 | 说明 |
|------|------|
| `-cc 编译器` | 指定 C 编译器(默认自动检测 gcc/clang) |
| `-m32` | 强制 32 位编译 |
| `-m64` | 强制 64 位编译 |
| `-h`, `--help` | 显示帮助信息 |
### 手动编译
你不必使用构建脚本。只需一条编译器命令即可:
**Windows (MinGW/MSYS2):**
```bat
gcc -O2 -std=gnu99 lua.c -o lua.exe
gcc -O2 -std=gnu99 luac.c -o luac.exe
```
**Linux:**
```sh
gcc -O2 -Wall -std=gnu99 -DLUA_USE_LINUX lua.c -o lua -lm -ldl -Wl,-E
gcc -O2 -Wall -std=gnu99 -DLUA_USE_LINUX luac.c -o luac -lm -ldl
```
**macOS:**
```sh
gcc -O2 -Wall -std=gnu99 -DLUA_USE_MACOSX lua.c -o lua -lm
gcc -O2 -Wall -std=gnu99 -DLUA_USE_MACOSX luac.c -o luac -lm
```
### 示例
```bat
:: 自动检测编译器
lua_single_build.bat
:: 强制 32 位
lua_single_build.bat -m32
:: 指定编译器
lua_single_build.bat -cc gcc
:: 手动编译(任意平台)
gcc -O2 lua.c -o lua -lm
```
## 验证
```bat
:: Windows
lua.exe -v
```
```sh
# Linux/macOS
./lua -v
```
预期输出:`Lua 5.5.0`
## 文件说明
| 文件 | 说明 |
|------|------|
| `lua.c` | 合并的跨平台 Lua 解释器源码 |
| `luac.c` | 合并的跨平台 Lua 编译器源码 |
| `lua.h` | 合并的跨平台 Lua 头文件 |
| `lua_single_build.bat` | Windows 编译脚本 |
| `lua_single_build.sh` | Linux / macOS 编译脚本 |
| `merge_lua_helper.py` | 从 `src/` 重新生成合并文件的 Python 脚本 |
| `src/` | Lua 5.5 官方源码目录 |
## 平台支持
| 平台 | 编译器 | 输出 |
|------|--------|------|
| **Windows** (MinGW / MSYS2) | gcc, clang | `lua.exe`, `luac.exe` |
| **Linux** | gcc, clang | `lua`, `luac` |
| **macOS** | gcc, clang | `lua`, `luac` |
## 架构支持
Lua 源码完全可移植,可在任何有标准 C 编译器的架构上编译。
| 架构 | 支持情况 |
|------|---------|
| x86 (i386/i686) | 支持 |
| x86_64 | 支持 |
| ARM32 / ARM64 (aarch64) | 支持 |
| RISC-V | 支持 |
| MIPS / PowerPC | 支持 |
## Lua 是什么?
Lua 是一种功能强大、高效、轻量级、可嵌入的脚本语言。它支持过程式编程、面向对象编程、函数式编程、数据驱动编程和数据描述。
Lua 将简单的过程式语法与基于关联数组和可扩展语义的强大数据描述结构相结合。Lua 是动态类型的,通过基于寄存器的虚拟机解释字节码运行,并具有增量垃圾回收的自动内存管理,使其非常适合配置、脚本编写和快速原型开发。
### Lua 快速上手
```sh
# 运行 Lua 脚本
lua script.lua
# 运行一行代码
lua -e "print('Hello, World!')"
# 交互式 REPL
lua
# 将脚本编译为字节码
luac -o output.luac input.lua
# 运行编译后的字节码
lua output.luac
```
## 参考链接
### 官方源码
Lua 由巴西里约热内卢天主教大学(PUC-Rio)开发。
- **Lua 官网**:
- **源码仓库**:
- **Lua 用户 Wiki**:
- **使用版本**:5.5.0
### 官方文档
- **Lua 参考手册**:
- **Programming in Lua**:
- **Lua FAQ**:
### 相关项目
- **LuaJIT**: — Lua 即时编译器
- **LuaRocks**: — Lua 模块包管理器
- **LÖVE**: — Lua 2D 游戏框架
## 许可证
Lua 是自由软件,以 **MIT 许可证** 的条款分发。
详见 `doc/readme.html` 文件。
Copyright © 1994–2025 Lua.org, PUC-Rio.