
5 分鐘跑通 CloudCompare 源碼編譯從最小版本到定制構建的完整指南【免費下載鏈接】CloudCompareCloudCompare main repository項目地址: https://gitcode.com/gh_mirrors/cl/CloudCompareCloudCompare 是一款開源的 3D 點云與網格處理軟件配準、分割、分類、距離計算、柵格化這些點云后處理的核心操作它幾乎全覆蓋。直接裝官方包當然省事但CloudCompare 源碼編譯才讓你拿到自己想要的東西——只編譯需要的插件、接入內部依賴、或者改幾行邏輯重新出包。整個過程比想象中簡單先跑通一個最小版本再按需求逐項加料。5 分鐘拿到第一個可執行文件先給結論只要CMake Qt兩樣東西外加一條帶--recursive的克隆命令其余全靠默認值。CMake3.13 及以上Linux 上舊版 CMake 會導致 rpath 問題后面細說Qt當前主線2.14要求 Qt 6如果你維護的是 2.13 舊分支則支持 Qt 5.12–5.15平臺Qt 獲取方式說明WindowsQt 官網安裝器裝時記得勾選對應編譯器套件如 msvc2019_64macOS官網安裝器或 Homebrew也可用倉庫自帶的 pixi 一鍵環境Linux發行版包管理器Ubuntu 24 裝 Qt6 系列包舊版裝qt5-default全家桶然后就是四步走全程不到一杯咖啡的時間# 1. 克隆--recursive 必須帶外部庫和插件走的是 Git 子模塊 git clone --recursive https://gitcode.com/gh_mirrors/cl/CloudCompare cd CloudCompare # 2. 配置Windows / macOS 需告訴 CMake Qt 在哪Linux 一般可省略 mkdir build cd build cmake -DCMAKE_PREFIX_PATH你的Qt路徑 .. # 3. 構建 cmake --build . --parallel # 4. 安裝到指定目錄可執行文件、插件、資源會按平臺規則落位 cmake --install .構建完成后Linux 下可執行文件在build/bin/Windows / macOS 走安裝流程分別落到CloudCompare/和ccViewer/目錄。能雙擊打開主窗口恭喜最小版本通了。按需增強我要什么就打開什么最小版本之外所有增強項都是 CMake 階段一個-D開關ON的事。下面按目標 → 開關的方式組織照著查就行。核心功能開關你的目標打開什么備注不想編譯精簡查看器 ccViewer-DOPTION_BUILD_CCVIEWEROFF默認 ON讀取 SHP / DXF 矢量文件不用動默認開啟OPTION_USE_SHAPE_LIB/OPTION_USE_DXF_LIB需要裁剪時才關讀取各類柵格文件DEM、影像等-DOPTION_USE_GDALON需自備 GDAL填頭文件/庫/DLL 三個路徑變量GL 插件改視覺效果你的目標打開什么點云深度感更強Eye Dome Lighting-DPLUGIN_GL_QEDLON屏幕空間環境光遮蔽細節更立體-DPLUGIN_GL_QSSAOONIO 插件決定能打開什么文件你的目標打開什么額外依賴讀 LAS / LAZ最常用-DPLUGIN_IO_QLASONLASZIP推薦方案讀 E57 傳感器數據-DPLUGIN_IO_QE57ONXerces-C 靜態庫 libE57讀 Autodesk FBX-DPLUGIN_IO_QFBXONFBX SDK填 3 個路徑變量讀 STEP CAD 文件-DPLUGIN_IO_QSTEPONOpenCascade讀 PCD 等 PCL 格式-DPLUGIN_STANDARD_QPCLONPCL 庫讀 CSV 矩陣 / RDB / DRC 等PLUGIN_IO_QCSV_MATRIX等對應開關視格式而定?? 兩個老方案qPDALIO、qLASFWFIO已標記棄用新構建請直接選 qLASIO別在棄用路上浪費時間。標準插件功能擴展全部在 plugins/core/Standard/ 目錄下命名規律是-DPLUGIN_STANDARD_插件名ON你的目標打開什么穩健的點云距離計算M3C2-DPLUGIN_STANDARD_QM3C2ON地面/非地面自動分類-DPLUGIN_STANDARD_QCSFON或 q3DMASC、qCanupo泊松表面重建-DPLUGIN_STANDARD_QPOISSON_RECONON交互式虛擬掃帚清理點云-DPLUGIN_STANDARD_QBROOMON錄制旋轉展示視頻-DPLUGIN_STANDARD_QANIMATIONON要出片再加-DQANIMATION_WITH_FFMPEG_SUPPORTON隱藏點去除、RANSAC 形狀檢測、環境光遮蔽等qHPR/qRANSAC_SD/qPCV對應開關所有開關可以在一次配置里疊加例如同時開 LAS 讀取和 EDL 效果cmake .. -DPLUGIN_IO_QLASON -DPLUGIN_GL_QEDLON三大平臺避坑指南Windows該做的Qt 用官網安裝器裝好想加快 Visual Studio 編譯就開-DOPTION_MP_BUILDON多進程編譯吃 CPU 但快。最容易踩的坑默認調試配置下按 F5 直接跑不起來——因為可執行文件、插件、DLL 必須先cmake --install到同一目錄才能一起工作。調試插件請先跑安裝再改啟動工作目錄。另外CMAKE_INSTALL_PREFIX別指向Program FilesCMake 沒有寫權限。macOS該做的最省心的路徑是倉庫自帶的 pixi 環境pixi.tomlpixi run build然后pixi run CloudCompare依賴全部托管要打包獨立.app用pixi run bundle。最容易踩的坑本地開發時程序默認從應用 bundle 找插件找不到剛編出來的。配置時加-DCC_MAC_DEV_PATHS讓它改從構建目錄加載再把需要的 shader 手動拷一份到構建目錄的shaders/下。Linux該做的Qt 走包管理器裝CMake 用 3.13 以上的新版本。最容易踩的坑老版本 CMake3.13編出來的程序會隱式鏈接/usr/local的庫換個用戶環境就跑不起來。另外裝到默認/usr/local需要管理員權限個人開發建議自定義CMAKE_INSTALL_PREFIX到 home 目錄下。排錯速查遇到 CloudCompare 編譯報錯九成集中在下面幾種癥狀處理辦法CMake 配置階段找不到 Qt補-DCMAKE_PREFIX_PATHQt根目錄Windows / macOS 必查項報 not advised to BUILD the binaries directly in the SOURCE folder別在源碼目錄里直接構建單獨建build/子目錄再來程序能跑但某個插件 / 中文不顯示 / 著色器缺失用環境變量指定搜索路徑見下DEBUG 模式單配置編譯器gcc 等下插件不加載在plugins/CMakePluginTpl.cmake里注釋掉QT_NO_DEBUG宏定義打開.pcd文件提示無法讀取編譯時沒開-DPLUGIN_STANDARD_QPCLON補上重新構建插件、著色器、翻譯文件的加載路徑支持三個環境變量覆蓋路徑可以是相對或絕對實現見 ccApplicationBase.cppexport CC_PLUGIN_PATH/path/to/plugins # 插件搜索路徑支持列表分隔符 export CC_SHADER_PATH/path/to/shaders # 著色器目錄 export CC_TRANSLATION_PATH/path/to/i18n # 翻譯文件目錄CC_PLUGIN_PATH的路徑優先級最高排在內置路徑和用戶 AppData 目錄之前——調試自己編的插件時直接指過去不用反復安裝。寫在最后CloudCompare 源碼編譯的骨架其實就一句話先跑通最小版本再用-D開關ON按需增強。完整的構建細節、各插件依賴的逐項說明都在倉庫根目錄的 BUILD.md 里更多可選插件的實現可以直接逛 plugins/core/ 下的 GL / IO / Standard 三個子目錄。編譯順利的話去 qCC/doc/ 翻翻內部文檔改點東西就是水到渠成的事了。【免費下載鏈接】CloudCompareCloudCompare main repository項目地址: https://gitcode.com/gh_mirrors/cl/CloudCompare創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考