You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

CLion关联WSL构建项目提示CMake版本过低,该如何解决?

WSL环境CLion编译提示CMake版本过低的解决方法

你执行的wsl --update仅用于更新WSL虚拟化核心组件,不会修改WSL内部Linux发行版的软件包版本。报错本质是WSL内默认安装的Linux发行版(通常为Ubuntu 20.04)官方源提供的CMake最高版本为3.16.3,低于你项目要求的3.20版本,可按以下方法解决:

方案1:通过Kitware官方APT源安装高版本CMake(推荐)

适用于Ubuntu/Debian系WSL发行版,直接安装官方维护的最新稳定版CMake:

  • 打开WSL发行版的终端,执行命令安装依赖:
    sudo apt update && sudo apt install apt-transport-https ca-certificates gnupg lsb-release -y
  • 导入Kitware官方GPG密钥:
    wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor | sudo tee /usr/share/keyrings/kitware-archive-keyring.gpg >/dev/null
  • 添加Kitware软件源:
    echo "deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/kitware.list >/dev/null
  • 执行更新并安装最新CMake:
    sudo apt update && sudo apt install cmake -y
  • 验证安装结果,确认版本高于3.20即可:
    cmake --version

方案2:通过pip快速升级CMake

无需修改系统软件源,适合已经安装Python3的环境:

  • WSL终端执行命令升级CMake:
    pip3 install cmake --upgrade
  • 执行命令将pip本地安装目录加入系统PATH:
    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
  • 验证版本:
    cmake --version

方案3:临时降低项目要求的CMake版本(仅作为临时兼容方案)

如果你的项目未使用CMake 3.20及以上的独有特性,可以直接修改CMakeLists.txt第一行:
将cmake_minimum_required(VERSION 3.20)改为cmake_minimum_required(VERSION 3.16),重新加载CMake配置即可直接编译。

后续CLion配置

完成升级后打开CLion,进入「设置>构建、执行、部署>工具链」,选择你配置的WSL工具链,点击「重新检测」按钮,确认CMake路径识别到新装的高版本CMake,重新加载项目CMake配置后再执行构建即可。

内容的提问来源于stack exchange,提问作者Pizza4Me

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.26 18:45:03