cmkr Windows开发必看一行配置搞定MSVC静态/动态运行时告别CRT运行错误【免费下载链接】cmkrModern build system based on CMake and TOML.项目地址: https://gitcode.com/gh_mirrors/cm/cmkrcmkr 是一款基于 CMake 和 TOML 的现代化 C 构建系统只需在cmake.toml中写一行msvc-runtime配置即可一键搞定 Windows 下 MSVC 静态/动态运行时的选择彻底告别缺少 VCRUNTIME140.dll这类 CRT 运行时错误。一、为什么 Windows 程序总报缺少 VCRUNTIME140.dll很多新手都会遇到这个崩溃现场程序在自己电脑上跑得飞快换台机器直接弹窗——程序无法正常启动因为缺少 VCRUNTIME140.dll。问题的根源在于 MSVC 的 CRTC 运行时有两种链接方式方式说明典型报错动态运行时默认依赖VCRUNTIME140.dll等运行时 DLL目标机器没装 VC 运行库 → 启动失败静态运行时运行时代码直接打进 exe体积略大但开箱即用而更隐蔽的坑是同一个程序里混用了静态/动态运行时的库轻则链接报 LNK2038重则std::string、std::vector传参时直接崩溃调试起来让人头皮发麻。传统 CMake 里你需要手动设置CMP0091策略、写CMAKE_MSVC_RUNTIME_LIBRARY变量、还要自己区分 Debug 和 Release 的MultiThreadedDebug/MultiThreaded变体……写错一个字母就是半天排查。而 cmkr 把这些全部收敛成了一行配置。✅二、认识 cmkr用 TOML 写 CMake3 分钟上手cmkr 的工作方式很简单你维护一份人类友好的cmake.toml它自动生成规范、地道的CMakeLists.txt。项目最小配置只有几行[project] name cmkr_for_beginners [target.hello_world] type executable sources [src/main.cpp]首次使用只需两步完成引导需要 CMake 和 C 编译器git clone https://gitcode.com/gh_mirrors/cm/cmkr cmake -P cmkr.cmake之后修改cmake.toml照常执行cmake -B build和cmake --build build即可cmkr 会在必要时自动重新生成CMakeLists.txt工作流零额外负担。更多基础概念可参考 docs/basics.md完整配置项见 docs/cmake-toml.md。三、一行配置msvc-runtime 搞定 MSVC 运行时 ️现在回到正题。想让整个 Windows 项目使用静态运行时在[project]段加一行就完事了[project] name myproject msvc-runtime static # 默认是 dynamic动态就这么简单——cmkr 会自动处理 CMake 策略、运行时变量并且自动为 Debug 配置加上Debug变体MultiThreadedDebug你不需要操心Debug与Release的差异。官方示例 tests/msvc-runtime/cmake.toml 演示了完整用法值得照着抄[project] name msvc-runtime msvc-runtime static # 项目级默认静态 [target.static-runtime] type executable sources [src/main.cpp] # 单个目标可以覆盖项目级设置 [target.dynamic-runtime] type executable sources [src/main.cpp] msvc-runtime dynamic四、项目级 vs 目标级灵活控制每个目标的运行时msvc-runtime可以在两个层级配置灵活度拉满项目级[project]段对全项目所有目标生效保证运行时一致强烈推荐默认设置目标级[target.xxx]段单独覆盖某个目标的运行时适合发布版主程序用静态、内部调试工具用动态的场景。 注意一个细节目标级覆盖依赖项目级先启用。如果根项目没有设置msvc-runtime单独给某个目标设置会直接报错提示——这是 cmkr 故意设计的保护机制避免你在不知情的情况下引入运行时混用。五、背后原理cmkr 帮你生成了什么 CMake 代码好奇它是怎么做到一行顶十行的可以看看 cmkr 生成的CMakeLists.txt核心逻辑在 src/cmake_generator.cpp 中实现等价于cmake_policy(SET CMP0091 NEW) if(NOT DEFINED CMAKE_MSVC_RUNTIME_LIBRARY) set(CMAKE_MSVC_RUNTIME_LIBRARY MultiThreaded$$CONFIG:Debug:DebugDLL) # 或 MultiThreaded$$CONFIG:Debug:Debugstatic 时 endif()也就是说 cmkr 替你做对了三件容易出错的事开启 CMP0091 策略——这是MSVC_RUNTIME_LIBRARY能正常工作的前提用生成器表达式自动区分 Debug/Release——$$CONFIG:Debug:Debug保证调试版链接ucrt调试运行时不会被 IDE 的默认值覆盖NOT DEFINED保护——尊重你通过命令行传入的覆盖值不会强买强卖。这也解释了为什么它比手写-MT/-MD编译参数更可靠后者绕过了 CMake 的属性传播机制在多目标、依赖第三方库时极易翻车。六、常见问题 FAQQ1静态运行时后 exe 体积变大值得吗发布型工具、插件、绿色软件值得——用户机器不需要预装任何 VC 运行库大型应用可保持动态配合安装包分发运行库即可。Q2cmkr 在 Linux/macOS 上会报错吗不会。msvc-runtime只影响 MSVC 编译器在其他平台上该设置会被自然忽略一份cmake.toml即可跨平台构建。Q3和 vcpkg 等第三方库混用会冲突吗不会。第三方库按自身的运行时构建只需保证你自己的目标运行时统一即可如果 vcpkg 包使用了与你不同的运行时cmkr 会像标准 CMake 项目一样给出明确的 LNK2038 链接错误提示方便定位。七、总结需求配置全项目动态运行时默认不配置或msvc-runtime dynamic全项目静态运行时[project]下msvc-runtime static单目标覆盖[target.xxx]下再次设置msvc-runtime一句话总结cmkr 让你用一行 TOML 配置获得了标准 CMake 手写十几行代码才能稳定做到的 MSVC 运行时控制。无论你是要打包一个免安装 VC 运行库的绿色工具还是要根治团队项目里玄学般的 CRT 崩溃这份配置都是 Windows C 开发的必修课。相关源码与文档构建脚本引导见 cmake/cmkr.cmake运行时生成逻辑见 src/cmake_generator.cpp官方 MSVC 运行时示例见 tests/msvc-runtime/cmake.toml。【免费下载链接】cmkrModern build system based on CMake and TOML.项目地址: https://gitcode.com/gh_mirrors/cm/cmkr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 cmkr Windows开发必看：一行配置搞定MSVC静态/动态运行时，告别CRT运行错误
cmkr Windows开发必看一行配置搞定MSVC静态/动态运行时告别CRT运行错误【免费下载链接】cmkrModern build system based on CMake and TOML.项目地址: https://gitcode.com/gh_mirrors/cm/cmkrcmkr 是一款基于 CMake 和 TOML 的现代化 C 构建系统只需在cmake.toml中写一行msvc-runtime配置即可一键搞定 Windows 下 MSVC 静态/动态运行时的选择彻底告别缺少 VCRUNTIME140.dll这类 CRT 运行时错误。一、为什么 Windows 程序总报缺少 VCRUNTIME140.dll很多新手都会遇到这个崩溃现场程序在自己电脑上跑得飞快换台机器直接弹窗——程序无法正常启动因为缺少 VCRUNTIME140.dll。问题的根源在于 MSVC 的 CRTC 运行时有两种链接方式方式说明典型报错动态运行时默认依赖VCRUNTIME140.dll等运行时 DLL目标机器没装 VC 运行库 → 启动失败静态运行时运行时代码直接打进 exe体积略大但开箱即用而更隐蔽的坑是同一个程序里混用了静态/动态运行时的库轻则链接报 LNK2038重则std::string、std::vector传参时直接崩溃调试起来让人头皮发麻。传统 CMake 里你需要手动设置CMP0091策略、写CMAKE_MSVC_RUNTIME_LIBRARY变量、还要自己区分 Debug 和 Release 的MultiThreadedDebug/MultiThreaded变体……写错一个字母就是半天排查。而 cmkr 把这些全部收敛成了一行配置。✅二、认识 cmkr用 TOML 写 CMake3 分钟上手cmkr 的工作方式很简单你维护一份人类友好的cmake.toml它自动生成规范、地道的CMakeLists.txt。项目最小配置只有几行[project] name cmkr_for_beginners [target.hello_world] type executable sources [src/main.cpp]首次使用只需两步完成引导需要 CMake 和 C 编译器git clone https://gitcode.com/gh_mirrors/cm/cmkr cmake -P cmkr.cmake之后修改cmake.toml照常执行cmake -B build和cmake --build build即可cmkr 会在必要时自动重新生成CMakeLists.txt工作流零额外负担。更多基础概念可参考 docs/basics.md完整配置项见 docs/cmake-toml.md。三、一行配置msvc-runtime 搞定 MSVC 运行时 ️现在回到正题。想让整个 Windows 项目使用静态运行时在[project]段加一行就完事了[project] name myproject msvc-runtime static # 默认是 dynamic动态就这么简单——cmkr 会自动处理 CMake 策略、运行时变量并且自动为 Debug 配置加上Debug变体MultiThreadedDebug你不需要操心Debug与Release的差异。官方示例 tests/msvc-runtime/cmake.toml 演示了完整用法值得照着抄[project] name msvc-runtime msvc-runtime static # 项目级默认静态 [target.static-runtime] type executable sources [src/main.cpp] # 单个目标可以覆盖项目级设置 [target.dynamic-runtime] type executable sources [src/main.cpp] msvc-runtime dynamic四、项目级 vs 目标级灵活控制每个目标的运行时msvc-runtime可以在两个层级配置灵活度拉满项目级[project]段对全项目所有目标生效保证运行时一致强烈推荐默认设置目标级[target.xxx]段单独覆盖某个目标的运行时适合发布版主程序用静态、内部调试工具用动态的场景。 注意一个细节目标级覆盖依赖项目级先启用。如果根项目没有设置msvc-runtime单独给某个目标设置会直接报错提示——这是 cmkr 故意设计的保护机制避免你在不知情的情况下引入运行时混用。五、背后原理cmkr 帮你生成了什么 CMake 代码好奇它是怎么做到一行顶十行的可以看看 cmkr 生成的CMakeLists.txt核心逻辑在 src/cmake_generator.cpp 中实现等价于cmake_policy(SET CMP0091 NEW) if(NOT DEFINED CMAKE_MSVC_RUNTIME_LIBRARY) set(CMAKE_MSVC_RUNTIME_LIBRARY MultiThreaded$$CONFIG:Debug:DebugDLL) # 或 MultiThreaded$$CONFIG:Debug:Debugstatic 时 endif()也就是说 cmkr 替你做对了三件容易出错的事开启 CMP0091 策略——这是MSVC_RUNTIME_LIBRARY能正常工作的前提用生成器表达式自动区分 Debug/Release——$$CONFIG:Debug:Debug保证调试版链接ucrt调试运行时不会被 IDE 的默认值覆盖NOT DEFINED保护——尊重你通过命令行传入的覆盖值不会强买强卖。这也解释了为什么它比手写-MT/-MD编译参数更可靠后者绕过了 CMake 的属性传播机制在多目标、依赖第三方库时极易翻车。六、常见问题 FAQQ1静态运行时后 exe 体积变大值得吗发布型工具、插件、绿色软件值得——用户机器不需要预装任何 VC 运行库大型应用可保持动态配合安装包分发运行库即可。Q2cmkr 在 Linux/macOS 上会报错吗不会。msvc-runtime只影响 MSVC 编译器在其他平台上该设置会被自然忽略一份cmake.toml即可跨平台构建。Q3和 vcpkg 等第三方库混用会冲突吗不会。第三方库按自身的运行时构建只需保证你自己的目标运行时统一即可如果 vcpkg 包使用了与你不同的运行时cmkr 会像标准 CMake 项目一样给出明确的 LNK2038 链接错误提示方便定位。七、总结需求配置全项目动态运行时默认不配置或msvc-runtime dynamic全项目静态运行时[project]下msvc-runtime static单目标覆盖[target.xxx]下再次设置msvc-runtime一句话总结cmkr 让你用一行 TOML 配置获得了标准 CMake 手写十几行代码才能稳定做到的 MSVC 运行时控制。无论你是要打包一个免安装 VC 运行库的绿色工具还是要根治团队项目里玄学般的 CRT 崩溃这份配置都是 Windows C 开发的必修课。相关源码与文档构建脚本引导见 cmake/cmkr.cmake运行时生成逻辑见 src/cmake_generator.cpp官方 MSVC 运行时示例见 tests/msvc-runtime/cmake.toml。【免费下载链接】cmkrModern build system based on CMake and TOML.项目地址: https://gitcode.com/gh_mirrors/cm/cmkr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考