VoiletCStudio/README.md

VoiletCStudio - 紫罗兰 C 工具箱

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

---

🚀 功能特性

1. 工程配置管理

• ✅ JSON 格式配置文件
• ✅ 新建/打开/保存工程
• ✅ Ctrl+S 快速保存

2. 编译工具链配置

• ✅ 编译器路径选择
• ✅ 汇编器路径选择
• ✅ 链接器路径选择
• ✅ 支持 MinGW/GCC/Clang

3. 文件管理

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

4. 编译配置

• ✅ 编译宏定义
• ✅ 自定义编译选项
• ✅ Debug/Release 模式

5. CMake 生成

• ✅ 自动生成 CMakeLists.txt
• ✅ 支持 make debug/release
• ✅ 跨平台兼容

---

📋 使用方法

编译

cd VoiletCStudio
qmake
make

运行

./VoiletCStudio

使用流程

1. 新建工程
2. 配置编译器路径
3. 添加虚拟目录和源文件
4. 添加包含目录和库文件
5. 添加编译宏和选项
6. 保存工程（JSON）
7. 生成 CMakeLists.txt
8. 使用 CMake 编译

---

🛠️ CMake 使用

# 配置
cmake -B build

# 编译 Debug
make debug

# 编译 Release
make release

# 或直接使用
cmake --build build --config Debug

---

📁 项目结构

VoiletCStudio/
├── src/
│   ├── main.cpp           # 主程序入口
│   ├── mainwindow.cpp/h   # 主窗口
│   ├── projectconfig.cpp/h # 配置管理
│   └── cmakegenerator.cpp/h # CMake 生成
├── resources/              # 资源文件
├── VoiletCStudio.pro       # Qt 项目文件
└── README.md               # 说明文档

---

💻 跨平台支持

平台	编译器	状态
Windows	MinGW	✅
Linux	GCC	✅
macOS	Clang	✅

---

📝 配置文件格式

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

---

🎯 特色

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

---

📄 许可证

MIT License

---

作者：虾哥
日期：2026-04-09