cmkr快速上手教程:3行TOML配置,5分钟从零构建你的第一个C++项目

发布时间:2026/8/22 14:24:08
cmkr快速上手教程:3行TOML配置,5分钟从零构建你的第一个C++项目 cmkr快速上手教程3行TOML配置5分钟从零构建你的第一个C项目【免费下载链接】cmkrModern build system based on CMake and TOML.项目地址: https://gitcode.com/gh_mirrors/cm/cmkrcmkr是一个基于 CMake 和 TOML 的现代 C 构建系统你只需编写一个简洁的cmake.toml配置文件它会自动为你生成规范、地道的CMakeLists.txt。对于新手来说告别冗长的 CMake 脚本几分钟就能从零构建并运行第一个 C 项目。为什么选择 cmkr告别繁琐的 CMake 脚本传统 CMake 项目需要手写大量CMakeLists.txt配置繁琐、容易出错。cmkr发音 cmaker把这一切简化为一个 TOML 文件它会自动解析cmake.toml并生成现代、地道的CMakeLists.txt。它有几个对新手非常友好的特点✅配置极简一个最小项目只需 3 行 TOML 配置✅零额外依赖只需要 CMake 和一个 C 编译器就能使用✅自动化生成修改cmake.toml后重新构建CMakeLists.txt会自动重新生成✅CI 零开销在 CI 环境中会跳过引导过程不增加流水线负担准备工作安装 CMake 和 C 编译器开始之前确认你的电脑已安装CMake3.15 及以上版本官方文档见 CMake 官网C 编译器如 GCC、Clang 或 MSVC可在终端输入cmake --version检查是否已安装。第1步获取 cmkr 引导脚本cmkr 支持自我引导bootstrap。最简单的方式是克隆仓库获取引导脚本git clone https://gitcode.com/gh_mirrors/cm/cmkr然后将引导脚本cmake/cmkr.cmake复制到你的项目根目录重命名为cmkr.cmake在你的项目目录下执行cmake -P cmkr.cmake引导完成后项目里会生成cmake.toml你可以直接开始定制。注意cmake.toml、生成的CMakeLists.txt和cmkr.cmake三个文件都应该提交到版本库中。第2步编写 cmake.toml核心 3 行配置这是最关键的一步。打开项目根目录的cmake.toml一个最小可运行的 C 项目配置如下[project] name cmkr_for_beginners [target.hello_world] type executable sources [src/main.cpp]其中核心只有 3 行配置项含义type executable声明这是一个可执行程序目标sources [src/main.cpp]指定要编译的源文件name ...项目名称然后在src/main.cpp写入你的第一行 C 代码即可。这个写法等价于 CMake 的add_executable(hello_world src/main.cpp)可以参考项目中的示例文件tests/basic/cmake.toml和入门文档docs/basics.md。第3步配置并构建项目引导完成后cmkr 不会给工作流增加任何额外步骤。标准的 CMake 两条命令即可cmake -B build cmake --build build构建成功后在build目录下就能看到你的可执行文件运行它——恭喜你的第一个 C 项目就跑起来了之后每次修改cmake.toml只需要重新执行构建cmkr 会在必要时自动重新生成CMakeLists.txt无需手动操作。常用 cmake.toml 配置速查掌握以下常用配置就能覆盖日常开发的大部分场景完整参考见docs/cmake-toml.md设置 C 标准如要求 C11 编译器[target.hello_world] type executable sources [src/main.cpp] compile-features [cxx_std_11]通配符收集源文件用*.cpp收集单目录文件用**.cpp递归收集子目录sources [src/*.cpp, mylib/**.cpp]跨平台条件编译内置了windows、linux、macos、gcc、msvc等预定义条件前缀加到任意配置项前即可生效例如只在 Windows 下添加源文件windows.sources [src/windows_only.cpp]常见问题快速解答cmkr 会替代 CMake 吗不会。它生成的是标准CMakeLists.txt完全兼容 Visual Studio、Ninja、Makefiles 等所有 CMake 生成器。可以只改 cmake.toml 吗可以而且推荐这样做。生成的CMakeLists.txt标注了 DO NOT EDIT请勿手改。如何清理构建目录重新执行cmake -B build即可构建产物与源码分离在build目录中随时可删除重建。从 3 行 TOML 配置到项目成功构建整个过程不超过 5 分钟。现在就可以动手创建你的第一个 cmkr 项目了【免费下载链接】cmkrModern build system based on CMake and TOML.项目地址: https://gitcode.com/gh_mirrors/cm/cmkr创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考