簡(jiǎn)介面向 Windows 64 位環(huán)境的 CMake 3.29.3 預(yù)編譯包為 C/C 開(kāi)發(fā)者提供開(kāi)箱即用的跨平臺(tái)構(gòu)建系統(tǒng)解決手工維護(hù)工程文件、切換編譯環(huán)境時(shí)配置繁瑣的問(wèn)題。zip 包內(nèi)共 2000 個(gè)文件其中 1157 個(gè) txt 文本與 843 個(gè) html 幫助文檔整體 43.63MBtxt 主要保存命令行輸出或配置示例html 則是 cmake、ctest、生成器表達(dá)式、預(yù)設(shè)、構(gòu)建系統(tǒng)與變量等主題的官方文檔頁(yè)面便于本地速查。已有 1021 人學(xué)習(xí)下載。包內(nèi)含完整的構(gòu)建系統(tǒng)說(shuō)明與常用命令參考覆蓋 CMakeLists.txt 編寫(xiě)、編譯選項(xiàng)與目標(biāo)平臺(tái)設(shè)置、靜態(tài)/動(dòng)態(tài)庫(kù)生成、依賴(lài)管理及跨平臺(tái)遷移等關(guān)鍵環(huán)節(jié)既適合剛接觸 CMake 的開(kāi)發(fā)者按文檔逐步實(shí)踐也為中高級(jí)用戶(hù)提供了版本對(duì)應(yīng)的權(quán)威索引避免因文檔版本不一致帶來(lái)的困擾。 做Windows下的C/C開(kāi)發(fā)繞不開(kāi)的名字就是CMake。cmake-3.29.3-windows-x86-64這個(gè)安裝包解決的正是“在Windows平臺(tái)上用一套現(xiàn)代化、跨平臺(tái)的構(gòu)建系統(tǒng)來(lái)組織項(xiàng)目”這件事。如果你被網(wǎng)上各種makefile、編譯器、IDE工程文件折騰到頭大那你多半會(huì)需要它。這個(gè)版本覆蓋了大多數(shù)常見(jiàn)需求支持Visual Studio生成器、MinGW、Ninja能處理CUDA、MPI、預(yù)編譯頭等高級(jí)配置同時(shí)對(duì)老項(xiàng)目的兼容性也不錯(cuò)。無(wú)論你是剛?cè)腴T(mén)的C/C學(xué)生還是要交差的實(shí)際工程項(xiàng)目這篇博文會(huì)把下載安裝、環(huán)境配置、命令使用到高頻報(bào)錯(cuò)排查的完整路線(xiàn)講清楚你照著操作就能把環(huán)境跑起來(lái)。我最早接觸CMake是在一個(gè)滿(mǎn)是遺留代碼的Windows項(xiàng)目里當(dāng)時(shí)版本亂七八糟PATH里還躺著一個(gè)2.8時(shí)代的CMake項(xiàng)目一構(gòu)建就報(bào)版本過(guò)低錯(cuò)誤。從那以后我養(yǎng)成了一個(gè)習(xí)慣先把安裝包和版本搞明白再動(dòng)手寫(xiě)CMakeLists.txt。下面就從文件名開(kāi)始把這個(gè)安裝包的方方面面拆開(kāi)講。1. 版本與平臺(tái)信息拆解文件名里的每個(gè)字段1.1 cmake-3.29.3這個(gè)版本意味著什么版本號(hào)3.29.3屬于CMake 3.29系列是個(gè)維護(hù)版本修復(fù)了上一批已知問(wèn)題。對(duì)普通使用者來(lái)說(shuō)3.29系列處在“功能夠用、生態(tài)兼容”的舒適區(qū)它支持Visual Studio 2022 17.10對(duì)CUDA的集成體驗(yàn)已經(jīng)很成熟預(yù)編譯頭的官方機(jī)制也穩(wěn)定了好幾個(gè)大版本W(wǎng)indows上常見(jiàn)的C項(xiàng)目都能順利處理。很多人在選擇版本時(shí)有個(gè)誤區(qū)裝了最新版就萬(wàn)事大吉。實(shí)際上版本選擇要看項(xiàng)目需要。如果項(xiàng)目CMakeLists.txt里寫(xiě)了cmake_minimum_required(VERSION 3.26)那3.29.3完全滿(mǎn)足如果你是維護(hù)老項(xiàng)目可能反而需要保留一個(gè)2.8/3.5的老版本配合舊依賴(lài)。3.29.3這個(gè)版本的最大優(yōu)勢(shì)就是“中間道路”——不至于新到踩坑也不至于舊到不支持現(xiàn)代寫(xiě)法。另外要區(qū)分軟件版本和平臺(tái)架構(gòu)。3.29.3只是CMake的版本它和你用的編譯器版本不是一回事。CMake本身只是個(gè)構(gòu)建工具真正編譯代碼的是Visual Studio、MinGW或者NinjaClang這些編譯工具鏈CMake負(fù)責(zé)把CMakeLists.txt翻譯成這些工具能識(shí)別的工程文件或構(gòu)建指令。理解這個(gè)分工后面很多報(bào)錯(cuò)就不會(huì)慌。1.2 windows-x86-64平臺(tái)與架構(gòu)怎么理解windows-x86-64表示這是面向Windows系統(tǒng)、x86-64也就是64位Intel/AMD處理器架構(gòu)的安裝包?，F(xiàn)在絕大多數(shù)PC都是這個(gè)架構(gòu)。這里有個(gè)常見(jiàn)的坑如果你的機(jī)器是ARM架構(gòu)的Windows比如Windows on ARM的筆記本這個(gè)x86-64安裝包雖然能在模擬層安裝但性能不好應(yīng)該去官方下載arm64版本。另外如果還有人找32位安裝包CMake從3.20左右開(kāi)始就逐步弱化對(duì)Windows 32位系統(tǒng)的官方支持老機(jī)器如果還在跑32位系統(tǒng)能選的老版本會(huì)越來(lái)越少這類(lèi)環(huán)境建議先升級(jí)系統(tǒng)或者退而求其次用zip包手動(dòng)解壓不寫(xiě)入注冊(cè)表也能繞過(guò)部分兼容問(wèn)題。安裝包格式上官方主推的是.msi和.zip兩種。.msi是Windows安裝程序會(huì)寫(xiě)入注冊(cè)表、自動(dòng)配置開(kāi)始菜單快捷方式還能在安裝時(shí)勾選“添加到PATH”適合絕大多數(shù)人。.zip是純綠色版解壓即用適合需要離線(xiàn)部署、或者不想污染注冊(cè)表的場(chǎng)景。它們底層的bin目錄文件一模一樣區(qū)別只是安裝方式。2. 下載、安裝與PATH配置一次到位2.1 下載渠道與校驗(yàn)下載CMake建議只認(rèn)官方渠道cmake.org的Downloads頁(yè)面?？吹健癱make-3.29.3-windows-x86-64.msi”和“cmake-3.29.3-windows-x86-64.zip”這兩個(gè)文件認(rèn)準(zhǔn)msi下載即可。下載完最好做一步校驗(yàn)。雖然官方下載走的是HTTPS但Windows環(huán)境下網(wǎng)絡(luò)代理、下載中斷都可能導(dǎo)致文件損壞。最簡(jiǎn)單的方式是下載后右鍵點(diǎn)擊msi文件看“屬性-數(shù)字簽名”確認(rèn)簽名正?；蛘哂肞owerShell計(jì)算文件哈希和官方提供的SHA-256值對(duì)比Get-FileHash .\cmake-3.29.3-windows-x86-64.msi -Algorithm SHA256哈希不一致就重新下載這一步花不了半分鐘能避免后面安裝到一半報(bào)錯(cuò)或者裝完跑不了的尷尬。2.2 安裝流程圖形化與靜默安裝雙擊msi文件進(jìn)入圖形化安裝界面。走到“Install Options”這一步時(shí)注意下方有個(gè)“Add CMake to the system PATH for all users”的選項(xiàng)這個(gè)復(fù)選框非常關(guān)鍵務(wù)必勾上。如果不勾CMake裝完只是裝完了命令行里輸入cmake --version會(huì)提示找不到命令。如果你需要批量部署可以用msiexec走靜默安裝msiexec /i cmake-3.29.3-windows-x86-64.msi /qn ADD_CMAKE_TO_PATHUser這里的/qn表示無(wú)人值守安裝“ADD_CMAKE_TO_PATHUser”表示把CMake加入當(dāng)前用戶(hù)的PATH。如果追求穩(wěn)妥建議直接選System讓所有用戶(hù)都能用安裝完以后打開(kāi)新終端再執(zhí)行命令即可。2.3 PATH配置與版本驗(yàn)證安裝完成后我們得確認(rèn)CMake真的“進(jìn)入”了系統(tǒng)。打開(kāi)新的cmd或PowerShell執(zhí)行cmake --version正常會(huì)顯示“cmake version 3.29.3”以及平臺(tái)信息。我強(qiáng)烈建議再執(zhí)行一條where cmake這條命令會(huì)列出系統(tǒng)PATH里所有cmake.exe的位置。它很有價(jià)值——如果你裝過(guò)多個(gè)版本的CMake或者電腦里有IDE自帶的CMakewhere cmake能看到當(dāng)前到底走的哪個(gè)路徑、會(huì)不會(huì)被另一個(gè)老版本搶了先。比如CLion、Visual Studio、Qt這類(lèi)開(kāi)發(fā)工具常自帶CMake它們的路徑如果排在前面你命令行的cmake版本可能就不是剛裝的3.29.3后續(xù)編譯老項(xiàng)目時(shí)容易遇到“版本過(guò)低”的詭異報(bào)錯(cuò)。如果安裝時(shí)沒(méi)勾PATH選項(xiàng)也可以手動(dòng)添加右鍵“此電腦-屬性-高級(jí)系統(tǒng)設(shè)置-環(huán)境變量”在“用戶(hù)變量”里找到Path把C:\Program Files\CMake\bin加進(jìn)去然后重啟終端。3. 核心用法速覽命令行與GUI雙模式3.1 命令行configure、build、install三連CMake日常使用圍繞三個(gè)核心命令展開(kāi)在Windows的cmd或PowerShell里都適用cmake -S . -B build cmake --build build cmake --install build --prefix D:/myapp第一條-S . -B build是關(guān)鍵。-S指定源代碼目錄當(dāng)前目錄-B指定構(gòu)建目錄。CMake會(huì)在build目錄下生成緩存文件CMakeCache.txt以及構(gòu)建系統(tǒng)文件。把構(gòu)建文件統(tǒng)一放在build目錄而不是源碼目錄是沿用多年的好習(xí)慣源碼樹(shù)保持干凈后期刪掉build重來(lái)也很方便。第二條--build build是真正觸發(fā)編譯的命令等價(jià)于在Visual Studio里點(diǎn)“生成”按鈕只不過(guò)在命令行做。第三條--install把編譯好的文件安裝到指定前綴目錄Windows下發(fā)到D:/myapp這樣的路徑方便打包分發(fā)。3.2 GUI模式什么時(shí)候用cmake-gui如果只是簡(jiǎn)單項(xiàng)目命令行就夠了。但Windows下涉及復(fù)雜選項(xiàng)時(shí)cmake-gui.exe是很好的排障工具。啟動(dòng)以后上面選源代碼目錄Where is the source code下面選構(gòu)建目錄Where to build the binaries點(diǎn)Configure選生成器紅色高亮項(xiàng)就是需要手動(dòng)配置的緩存變量比如CMAKE_CUDA_COMPILER、CMAKE_PREFIX_PATH這種。配置完成后點(diǎn)Generate生成工程。GUI的價(jià)值主要體現(xiàn)在三處一是看緩存變量的默認(rèn)值比如編譯器路徑、安裝前綴二是排查跨平臺(tái)配置問(wèn)題時(shí)能直觀地看到哪個(gè)模塊沒(méi)找到依賴(lài)三是給不熟悉命令行的人提供可視化入口。我自己通常在命令行配不出想要結(jié)果的時(shí)候就會(huì)切到GUI看兩眼往往一眼就能定位是哪個(gè)路徑?jīng)]寫(xiě)對(duì)。4. Windows項(xiàng)目實(shí)戰(zhàn)生成器選擇與編譯環(huán)境匹配4.1 生成器選型Visual Studio、MinGW、Ninja怎么選Windows上CMake把CMakeLists.txt轉(zhuǎn)換成指定構(gòu)建系統(tǒng)的工程文件“生成器”就是干這個(gè)的。最常見(jiàn)的有三派生成器對(duì)應(yīng)編譯環(huán)境適用場(chǎng)景輸出結(jié)果Visual Studio 17 2022微軟MSVCWindows首選企業(yè)項(xiàng)目、Windows API開(kāi)發(fā).sln解決方案MinGW MakefilesMinGW-w64的GCC喜歡GCC、跨平臺(tái)移植Linux代碼Makefile二進(jìn)制Ninja需額外安裝Ninja追求編譯速度、配合Clang/LLVMbuild.ninja文件項(xiàng)目需要調(diào)Windows API或者要給同事一份能直接打開(kāi)的.sln工程選Visual Studio生成器。代碼要從Linux遷過(guò)來(lái)、用GCC編譯選MinGW Makefiles。想要最快的增量編譯、又在用CLion或AS項(xiàng)目Ninja是更好的選擇。三者沒(méi)有絕對(duì)優(yōu)劣看團(tuán)隊(duì)和項(xiàng)目習(xí)慣。4.2 一個(gè)最小C項(xiàng)目的完整編譯流程我按“Visual Studio路線(xiàn)”和“MinGW路線(xiàn)”各走一遍你跟著敲就能跑。先準(zhǔn)備兩個(gè)文件。main.cpp#include iostream int main() { std::cout Hello CMake 3.29.3 on Windows std::endl; return 0; }CMakeLists.txtcmake_minimum_required(VERSION 3.20) project(HelloApp LANGUAGES CXX) add_executable(hello main.cpp)Visual Studio路線(xiàn)打開(kāi)“x64 Native Tools Command Prompt for VS 2022”或普通cmd執(zhí)行cmake -S . -B build -G Visual Studio 17 2022 -A x64 cmake --build build --config Release執(zhí)行完在build\Release目錄下能看到hello.exe。MinGW路線(xiàn)確保MinGW-w64的bin目錄在PATH里后執(zhí)行cmake -S . -B build-mingw -G MinGW Makefiles cmake --build build-mingw生成的可執(zhí)行文件直接出現(xiàn)在build-mingw目錄下。一個(gè)細(xì)節(jié)MinGW Makefiles默認(rèn)用g編譯如果系統(tǒng)還裝了MSVC、ClangCMake可能猜錯(cuò)編譯器這時(shí)可以用-DCMAKE_CXX_COMPILERg強(qiáng)制指定。Ninja的配置也順手提一下注意需要先裝Ninja并把ninja.exe所在目錄加入PATHcmake -S . -B build-ninja -G Ninja -DCMAKE_BUILD_TYPERelease cmake --build build-ninja5. 高頻報(bào)錯(cuò)與排查技巧實(shí)錄5.1 版本過(guò)低報(bào)錯(cuò)running version 2.8.12.2的前因后果我在開(kāi)發(fā)群里最?？吹降膱?bào)錯(cuò)長(zhǎng)這樣CMake 3.1.3...3.26 or higher is required. You are running version 2.8.12.2檢查思路很簡(jiǎn)單先看你運(yùn)行的是哪個(gè)cmake。where cmake如果查出兩個(gè)cmake.exe一個(gè)在老的IDE路徑下一個(gè)在C:\Program Files\CMake\bin那就是PATH優(yōu)先級(jí)問(wèn)題——老版本排前面把新版本擋了。處理辦法是調(diào)整環(huán)境變量把新版本所在的路徑挪到前面。還有一種情況項(xiàng)目是別人配好的CMakeLists.txt里cmake_minimum_required寫(xiě)得很高而你的環(huán)境只有舊版這就要么升級(jí)CMake要么讓項(xiàng)目降要求。2.8.12.2這種古董CMake還能在系統(tǒng)里出現(xiàn)多半是被某個(gè)老軟件捆綁安裝的定位到位置后直接卸載或刪除相關(guān)路徑即可。更隱蔽的情況是CMakeCache.txt里的緩存導(dǎo)致版本混淆。項(xiàng)目之前用舊版本配置過(guò)構(gòu)建目錄里殘留了緩存變量即便升級(jí)了CMake重新執(zhí)行cmake -S . -B build時(shí)仍然報(bào)版本錯(cuò)誤。這時(shí)候直接把build目錄刪掉重新配置大概率能解決。5.2 cmake_cuda_compiler not setCUDA編譯器未找到報(bào)錯(cuò)原文是CMake Error: CMAKE_CUDA_COMPILER not set, after EnableLanguage這是項(xiàng)目里寫(xiě)了enable_language(CUDA)或project(... LANGUAGES CXX CUDA)但CMake在PATH里找不到nvcc編譯器。Windows下原因幾乎都是沒(méi)裝CUDA Toolkit或者裝了但路徑對(duì)不上。解決方案是先把CUDA Toolkit裝上確保C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.x\bin里存在nvcc.exe。然后在配置時(shí)手動(dòng)指定編譯器cmake -S . -B build -DCMAKE_CUDA_COMPILERC:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.4/bin/nvcc.exe注意路徑用正斜杠避免轉(zhuǎn)義問(wèn)題。如果項(xiàng)目不用CUDA卻報(bào)這個(gè)錯(cuò)那就要回CMakeLists.txt里查是否不該開(kāi)啟CUDA語(yǔ)言。5.3 亂碼、緩存殘留、中文路徑等Windows特有問(wèn)題Windows下最容易踩的幾個(gè)坑我整理成速查表方便你對(duì)照癥狀觸發(fā)場(chǎng)景排查思路解決方案中文亂碼源碼含中文、編譯器與源文件編碼不一致檢查編譯器默認(rèn)編碼源文件存為UTF-8 with BOMMSVC加/utf-8編譯選項(xiàng)找不到編譯器只裝了IDE沒(méi)裝C組件VS Installer里確認(rèn)勾了“使用C的桌面開(kāi)發(fā)”補(bǔ)裝組件或改用已配好的MinGW路徑提示找不到Ninja選了Ninja生成器但未裝ninja --version驗(yàn)證下載ninja并加入PATH項(xiàng)目路徑帶中文項(xiàng)目放桌面或中文目錄CMake對(duì)非ASCII路徑支持不穩(wěn)把項(xiàng)目放到純英文路徑換生成器后報(bào)錯(cuò)從VS換MinGW舊緩存殘留刪除build目錄重新配置這些坑看起來(lái)小但每個(gè)都能卡人半小時(shí)。核心思路就一句話(huà)Windows下優(yōu)先保證“編譯器、CMake、項(xiàng)目路徑”三者都是清清爽爽的狀態(tài)別把變量藏得太深問(wèn)題就好排查。6. 進(jìn)階玩法Windows下CMake的高頻真實(shí)需求6.1 toolchain文件強(qiáng)制指定編譯器與交叉編譯“cmake toolchain”在Windows下平時(shí)用得不算多但遇到需要給嵌入式設(shè)備交叉編譯、或者強(qiáng)制切換編譯器時(shí)非常有用。Toolchain文件本質(zhì)就是個(gè)自定義的CMake腳本在最開(kāi)始被執(zhí)行用來(lái)提前告訴CMake“我打算用哪套工具鏈”。比如要在Windows上通過(guò)MinGW交叉編譯Windows API程序或者給樹(shù)莓派交叉編譯常見(jiàn)寫(xiě)法set(CMAKE_SYSTEM_NAME Windows) set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc) set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g) set(CMAKE_FIND_ROOT_PATH /usr/x86_64-w64-mingw32)使用時(shí)通過(guò)-DCMAKE_TOOLCHAIN_FILE傳入cmake -S . -B build -DCMAKE_TOOLCHAIN_FILEmy-toolchain.cmake注意一點(diǎn)toolchain文件里的CMAKE_SYSTEM_NAME一旦設(shè)置成非Windows的值CMake會(huì)放棄本機(jī)系統(tǒng)信息去找對(duì)應(yīng)的交叉編譯工具鏈。也就是說(shuō)在Windows上配置一個(gè)“目標(biāo)平臺(tái)為Windows”的toolchain文件意義不大真正的價(jià)值在跨平臺(tái)交叉編譯場(chǎng)景或者是集中管理編譯器路徑的大型項(xiàng)目。6.2 MPI、預(yù)編譯頭、CUDA擴(kuò)展配置這幾個(gè)點(diǎn)都是實(shí)際項(xiàng)目里高頻搜索的關(guān)鍵詞我在3.29.3上實(shí)測(cè)沒(méi)問(wèn)題分別說(shuō)下配置要點(diǎn)。MPI在Windows下的配置邏輯是先安裝Microsoft MPIMS-MPI然后在CMakeLists.txt里用標(biāo)準(zhǔn)模塊找包find_package(MPI REQUIRED) add_executable(mpi_app main.cpp) target_link_libraries(mpi_app PRIVATE MPI::MPI_CXX)編譯運(yùn)行時(shí)記得把MPI的bin目錄加入PATH否則exe啟動(dòng)時(shí)找不到msmpi.dll。預(yù)編譯頭是提升編譯速度的利器CMake 3.16起提供官方支持3.29.3用起來(lái)很順手target_precompile_headers(app PRIVATE vector string common.h )尖括號(hào)括起來(lái)的系統(tǒng)頭引號(hào)括起來(lái)的項(xiàng)目頭。這里要注意預(yù)編譯頭文件太長(zhǎng)、太雜反而會(huì)增加維護(hù)成本建議只放穩(wěn)定的大頭文件比如STL、第三方核心庫(kù)頭。CUDA的配置在上文提到過(guò)完整做法是project(CudaApp LANGUAGES CXX CUDA) find_package(CUDAToolkit REQUIRED) add_executable(cuda_app main.cu) target_link_libraries(cuda_app PRIVATE CUDA::cudart)配置時(shí)指定-DCMAKE_CUDA_COMPILER路徑。注意CUDA版本和顯卡驅(qū)動(dòng)要匹配如果報(bào)“no kernel image is available”多半是編譯用的CUDA版本和驅(qū)動(dòng)支持的版本對(duì)不上。我在實(shí)際項(xiàng)目里養(yǎng)成的一個(gè)習(xí)慣是新環(huán)境裝完CMake后第一時(shí)間跑一個(gè)最小demo項(xiàng)目確認(rèn)從configure到build全鏈路通暢再接手大面積代碼編譯和依賴(lài)引入。多花五分鐘省得后面在一堆報(bào)錯(cuò)里定位“其實(shí)是CMake本身有問(wèn)題”的尷尬情況。另外對(duì)桌面C開(kāi)發(fā)來(lái)說(shuō)如果同時(shí)裝了CLion、VS、Qt等工具盡量統(tǒng)一環(huán)境里只有命令行這一個(gè)CMake或者用where cmake檢查清楚每個(gè)工具的調(diào)用路徑讓構(gòu)建從源頭可控。本文還有配套的精品資源點(diǎn)擊獲取