# VoiletCStudio - 紫罗兰 C 工具箱

Qt5 跨平台 C 工程配置器，自动生成 CMakeLists.txt

> 版本：v1.1 · 2026-04-28

---

## 🚀 功能特性

### 1. 工程配置管理
- ✅ JSON 格式配置文件
- ✅ 新建/打开/保存工程
- ✅ 拖拽 JSON 文件打开
- ✅ Ctrl+S 快速保存

### 2. 编译工具链配置
- ✅ 编译器路径选择
- ✅ 汇编器路径选择
- ✅ 链接器路径选择
- ✅ 支持 MinGW / GCC / Clang
- ✅ Windows 下自动识别 MinGW 工具链

### 3. 文件管理
- ✅ 虚拟目录（类似 MDK）
- ✅ .c 源文件分类管理
- ✅ .h 包含目录管理
- ✅ 库文件管理（.a/.so/.lib）

### 4. 编译配置
- ✅ 编译宏定义
- ✅ 自定义编译选项
- ✅ Debug / Release 模式

### 5. CMake 生成
- ✅ 自动生成 CMakeLists.txt
- ✅ 编译器路径在 `project()` 之前设置，避免默认回退到 NMake
- ✅ Windows 下自动指定 `-G "MinGW Makefiles"` 生成器
- ✅ 内置一键编译（Debug / Release）

---

## 📋 使用方法

### 编译 VoiletCStudio

**Linux：**
```bash
cd VoiletCStudio
qmake
make
```

**Windows (MSYS2/MinGW)：**
```bash
cd VoiletCStudio
qmake
mingw32-make
```

### 运行
```bash
./VoiletCStudio         # Linux
VoiletCStudio.exe       # Windows
```

### 使用流程
1. 新建工程 → 输入工程名
2. 配置编译器路径（Windows 选 `gcc.exe`）
3. 添加虚拟目录和 .c 源文件
4. 添加包含目录和库文件
5. 添加编译宏和选项
6. 保存工程（JSON）
7. 点击「生成 CMake」→ 自动生成 CMakeLists.txt
8. 点击「编译 Debug / Release」→ 一键编译

---

## 🛠️ CMake 使用

```bash
# Linux / macOS
cmake -B build
make debug       # 编译 Debug
make release     # 编译 Release

# Windows (MinGW)
cmake -G "MinGW Makefiles" -B build
mingw32-make debug
mingw32-make release
```

---

## 📁 项目结构

```
VoiletCStudio/
├── src/
│   ├── main.cpp             # 主程序入口
│   ├── mainwindow.cpp/h     # 主窗口（含编译流程）
│   ├── projectconfig.cpp/h  # 配置管理
│   └── cmakegenerator.cpp/h # CMake 生成
├── VoiletCStudio.pro        # Qt 项目文件
├── README.md                # 说明文档
└── 需求规格说明书.md         # 详细需求文档
```

---

## 💻 跨平台支持

| 平台 | 编译器 | 生成器 | 状态 |
|------|--------|--------|------|
| Windows | MinGW (MSYS2) | MinGW Makefiles | ✅ |
| Windows | MSVC | NMake | ⚠️ 未测试 |
| Linux | GCC | Unix Makefiles | ✅ |
| macOS | Clang | Unix Makefiles | ✅ |

### Windows 特别注意
- 必须安装 **MSYS2** 并安装 `mingw-w64-gcc`、`mingw-w64-cmake`
- 编译器路径示例：`C:/msys2/mingw64/bin/gcc.exe`
- CMake 生成时程序自动使用 `-G "MinGW Makefiles"`
- 构建时使用 `mingw32-make` 而非 `make`

---

## 📝 配置文件格式

```json
{
    "projectName": "MyProject",
    "projectPath": "/path/to/project",
    "outputDir": "./build",
    "compilerPath": "/usr/bin/gcc",
    "assemblerPath": "/usr/bin/gcc",
    "linkerPath": "/usr/bin/gcc",
    "virtualDirs": {
        "App": {
            "name": "App",
            "files": ["src/main.c"]
        }
    },
    "includeDirs": ["./include"],
    "libraries": ["libmylib.a"],
    "defines": ["DEBUG"],
    "compilerOptions": ["-Wall"]
}
```

---

## 🔧 技术要点

### 编译器设置顺序
CMakeLists.txt 中 `CMAKE_C_COMPILER` **必须在 `project()` 之前设置**，否则 CMake 会在 `project()` 时自动检测编译器并可能回退到不存在的 NMake。

### Windows 生成器
程序通过 `#ifdef Q_OS_WIN32` 编译期检测平台，在 Windows 上自动：
- CMake 添加 `-G "MinGW Makefiles"` 参数
- 构建时使用 `mingw32-make` 替代 `make`
- 自动从编译器路径推导 `CMAKE_MAKE_PROGRAM`

---

## 🎯 特色

- **类 MDK 虚拟目录**：像 Keil MDK 一样管理源文件
- **一键生成 CMake**：自动生成完整的 CMakeLists.txt
- **真正跨平台**：Windows (MinGW) / Linux / macOS 全支持，自动化平台适配
- **轻量级**：纯 Qt5 实现，无额外依赖

---

## 📄 许可证

MIT License

---

**作者：虾哥**  
**日期：2026-04-09 · 更新：2026-04-28**