★ FEATURED ARTICLE 简介在Linux环境下搭建C编译工具链CMake的安装常因系统自带版本过旧、与项目要求不匹配或路径配置繁琐而耗费额外精力。这款官方3.27.6 x86_64版安装脚本面向开发者和运维人员兼容Ubuntu、CentOS等主流发行版可在系统自带版本不适用时快速部署指定版本CMake。资源包内共1个sh脚本压缩包整体48.9MB内嵌静默安装与自定义前缀参数既能跳过许可证交互又能把CMake装到自定义目录省去源码编译、依赖解析以及后续环境变量配置大幅缩短部署时间。脚本简洁透明非常适合内网离线安装、CI/CD流水线自动调用以及多版本CMake并行管理对于刚接触Linux的初学者也是一条低门槛的上手路径。目前已有1703人学习/下载无论是日常开发、容器镜像构建还是自动化测试环境准备这份资源都能直接派上用场。1. 为什么优先用 cmake-3.27.6-linux-x86-64.sh跳过源码编译十分钟把 CMake 装好提到给 Linux 装 CMake 3.27.6很多人的第一反应是下载源码、跑 bootstrap、再 make install顺手还要处理 OpenSSL 和 libuv 依赖。而 cmake-3.27.6-linux-x86-64.sh 是 CMake 官方发布的二进制自解压安装脚本里面装的是已经编译好的整套工具执行一次脚本CMake 就被完整复制到指定目录。它不需要编译器不需要第三方开发库安装过程不会去动系统已有的 /usr/bin/cmake卸载也只是删掉一个目录。这套做法最适合内网服务器、临时构建机、CI 镜像这类场景也适合不想为编译参数反复折腾的开发者。新手用它省掉一半安装时间老手可以把安装动作写进部署脚本失败点少结果可预期。2. 下载前先确认架构与校验uname -m、wget、sha256sum 三件事缺一不可2.1 为什么我坚持用官方脚本而不是源码编译在 Linux 上装 CMake通常有三条路发行版包管理器直接装、源码编译、官方预编译 .sh 脚本。包管理器最快但版本往往落后很多服务器的默认源里还停留在 3.16 到 3.20 之间项目里一旦要求 3.27.6包管理器这条路就断了。源码编译能拿到任意版本代价是时间还要先解决依赖缺 OpenSSL 开发包缺 libuv缺编译器版本不对任何一个环节都可能让整个安装过程卡住。官方二进制 .sh 脚本本质上是一个自解压包脚本头部是安装逻辑尾部是预编译好的 CMake 目录归档。执行一次等同于把一套完整工具解压到指定前缀目录。我一般建议构建服务器上用 .sh 而不是源码编译原因很直接源码编译的产出和当前系统的 GCC、OpenSSL 版本绑定换一台机器、换一批依赖版本编出来的 CMake 行为可能不一致。而 .sh 里的二进制在可控环境里编译好行为可预期网上搜到的问题和解决方案也更容易对号入座。2.2 确认平台是 x86_64而不是 aarch64# 输出 x86_64 才和 cmake-3.27.6-linux-x86-64.sh 匹配 uname -m # 顺手看一眼系统 GLIBC 版本老机器可能要提前判断能不能跑官方二进制 ldd --version | head -1逻辑说明uname -m 输出的是当前机器的 CPU 架构。输出 x86_64说明是 64 位 Intel/AMD 平台可以继续使用这个安装脚本如果输出 aarch64 或 armv7l要去下载对应的 aarch64 版本否则执行时会报 Exec format error。参数说明ldd --version 头一行会显示 glibc 版本。CMake 3.27.6 的官方二进制对系统 libc 有最低版本要求服务器太老时先看到这个数字后面遇到 GLIBC 相关报错就能快速定位。这一步不花时间但能省下后面排查的一大段路。2.3 用 wget 或 curl 把安装脚本拉下来# wget 方式-O 指定保存后的文件名避免服务端改写文件名 wget -O cmake-3.27.6-linux-x86-64.sh 你的下载源里 cmake-3.27.6-linux-x86-64.sh 的完整地址 # curl 方式-f 让 HTTP 错误时返回非零退出码-sSL 静默但保留重定向 curl -fsSL -o cmake-3.27.6-linux-x86-64.sh 你的下载源里 cmake-3.27.6-linux-x86-64.sh 的完整地址 # 下载完看一眼大小正常应该在几十 MB 量级只有几 KB 基本是错误页 ls -lh cmake-3.27.6-linux-x86-64.sh逻辑说明实际环境中下载源可能是官网、内网镜像或公司内部的软件仓库把地址替换成自己环境里可用的完整链接即可。wget 和 curl 哪个顺手用哪个关键参数别漏。参数说明wget 的 -O 指定输出文件名curl 的 -fsSL 四个参数分别表示传输失败时退出非零、静默、出错仍显示错误信息、跟随重定向。CI 脚本里我偏好 curl -fsSL因为失败后流水线能立刻标红。2.4 sha256sum 校验防止下载不完整或文件被替换# 拉取下载源里对应的 SHA-256 校验文件 wget -O CMakeSHA256.txt 你的下载源里校验文件的完整地址 # 从校验文件里找到安装脚本对应的 hash 行 grep cmake-3.27.6-linux-x86-64.sh CMakeSHA256.txt # 计算本地安装脚本的 hash和上面 grep 出的那行做比对 sha256sum cmake-3.27.6-linux-x86-64.sh逻辑说明下载源会提供 SHA-256 校验文件里面列出了每个分发文件的哈希值。把本地计算出的 hash 和校验文件里那一行比对一致说明文件完整且没有被掉包不一致就重新下载不要抱有侥幸心理去执行。如果校验文件格式标准也可以直接让 sha256sum 自己干活# --check 按校验文件逐行核对--ignore-missing 跳过当前目录不存在的文件 sha256sum --check --ignore-missing CMakeSHA256.txt逻辑说明输出里出现 cmake-3.27.6-linux-x86-64.sh: OK 表示校验通过。这里需要把校验文件放回安装脚本所在目录否则 --check 找不到文件。2.5 .sh 自解压脚本和 .tar.gz 二进制包的差别对比项.sh 自解压脚本.tar.gz 二进制包安装动作执行脚本并传参数解压到目录后手动配置 PATH无人值守能直接写进 CI要自己处理解压和 PATH目录控制--prefix、--exclude-subdir解压后自己移动常见坑忘加 --exclude-subdir顶层目录名带着版本号两者内容几乎一样差异在安装体验。.sh 把安装路径、license、子目录处理都做成了参数适合反复执行.tar.gz 更像一个压缩包所有事情自己接管。对 3.27.6 这套我习惯用 .sh因为它和 --skip-license --exclude-subdir 组合起来可以做到完全静默、可重入的安装。3. 执行安装脚本--prefix、--skip-license、--exclude-subdir 三个参数决定安装结果3.1 一条最标准的安装命令# 有 root 权限装到 /opt 下路径带版本号方便以后多版本共存 sudo mkdir -p /opt/cmake-3.27.6 sudo /bin/sh cmake-3.27.6-linux-x86-64.sh --prefix/opt/cmake-3.27.6 --skip-license --exclude-subdir逻辑说明常见做法是装在 /opt 而不是 /usr/local。/opt 下一个目录对应一个版本卸载时直接删目录不碰系统包管理器管理的文件。使用 /bin/sh 而不是 ./cmake.sh 执行是为了不依赖文件的 x 权限也避免脚本在 root 环境下调用到意外的 shell。参数说明--prefix 指定安装根目录所有文件都会落到它下面--skip-license 跳过许可确认无人值守安装必须加否则脚本会停下来等人输入--exclude-subdir 是关键中的关键它让解压内容直接进入 /opt/cmake-3.27.6而不是嵌套一层带版本号的子目录。3.2 普通用户没有 root 权限时怎么办# 没有 root 就装到用户目录原理完全一样 mkdir -p $HOME/opt/cmake-3.27.6 /bin/sh cmake-3.27.6-linux-x86-64.sh --prefix$HOME/opt/cmake-3.27.6 --skip-license --exclude-subdir逻辑说明没有 root 权限时装到用户主目录下后面 PATH 指向 $HOME/opt/cmake-3.27.6/bin。共享服务器上我一般这么干不影响别人也不用担心 /opt 没写权限。参数说明--exclude-subdir 不是必须的如果你打算在同一 prefix 下管理多个版本保留版本目录有时反而更好辨认。但对绝大多数人我建议统一加上让安装结果符合直觉。3.3 忘记 --exclude-subdir 会多出一层目录# 安装后如果少了 --exclude-subdir可执行文件实际在 ls -l /opt/cmake-3.27.6/cmake-3.27.6-linux-x86-64/bin/cmake # 用户预期中的路径是 ls -l /opt/cmake-3.27.6/bin/cmake这个自解压包默认会在 prefix 下保留原始顶层目录名。也就是说--prefix/opt/cmake-3.27.6 之后内容被放到了 /opt/cmake-3.27.6/cmake-3.27.6-linux-x86-64/ 下。表面上脚本执行成功但按 /opt/cmake-3.27.6/bin/cmake 去找文件的人会以为装出一个空目录。我一般会统一加 --exclude-subdir让安装结果符合预期。如果你确实想保留版本目录PATH 就要写深一层后续维护时每次都要多带一层路径容易出错。3.4 安装后的目录结构与文件清单# 列出安装目录前两层文件快速看结构是否符合预期 find /opt/cmake-3.27.6 -maxdepth 2 -type f | sed s#/opt/cmake-3.27.6/## | sort | head -30正常安装后bin、doc、share 会直接出现在 /opt/cmake-3.27.6 下。bin 里有三个核心可执行文件目录结构大致如下文件或目录作用bin/cmakeCMake 主命令bin/ctest测试驱动命令bin/cpack打包发布命令share/cmake-3.27/模块与模板文件doc/cmake-3.27/官方文档CMake 预编译包的自包含程度很高核心二进制不依赖你自己编译的库只要求系统 libc 满足版本要求。所以这个目录可以整体复制到另一台同架构 Linux 机器上直接使用这是很多人没用起来的一个技巧。3.5 安装后立刻验证# 用绝对路径直接验证不依赖 PATH排除环境变量干扰 /opt/cmake-3.27.6/bin/cmake --version # 确认文件类型排除架构搞错导致的 Exec format error file /opt/cmake-3.27.6/bin/cmake输出第一行必须是 cmake version 3.27.6。如果 --version 报 ELF 错误或 GLIBC 缺失多半是架构不匹配或系统太老直接到第 5 章的问题列表里排查。file 命令只需要几秒钟就能确认这是一个 x86-64 架构的动态链接可执行文件。4. 让 bash 找到新版本PATH 配置、hash 缓存与多版本切换4.1 为什么安装完敲 cmake 还是老版本很多人在这一步开始翻车明明脚本执行成功打开新终端cmake --version 出来的还是系统自带版本。这不是安装失败而是 shell 根本没去 /opt/cmake-3.27.6/bin 找 cmake。原因有两个层面。第一命令是依靠 PATH 环境变量按顺序查找的系统自带 cmake 在 /usr/bin/cmake而 /usr/bin 通常排在 PATH 靠前的位置第二bash 会把查找过的命令路径缓存下来修改 PATH 后有时仍然用旧缓存。两者叠加就会出现装了新版本却还在用旧命令的情况。4.2 先把 PATH 指到新版本再验证export PATH/opt/cmake-3.27.6/bin:$PATH hash -r which cmake cmake --version逻辑说明export 把新目录放到 PATH 最前面hash -r 清掉 bash 的命令路径缓存。之后 which cmake 应该显示 /opt/cmake-3.27.6/bin/cmakecmake --version 才会是 3.27.6。顺序很重要不要先 which 后 hash。which 在清缓存之前执行可能给你一个旧路径的错觉让你误以为 PATH 设置无效。先清缓存再查结果才可信。4.3 用户级配置写入 ~/.bashrcecho export PATH/opt/cmake-3.27.6/bin:$PATH ~/.bashrc source ~/.bashrc逻辑说明export 追加到 ~/.bashrc 后每次登录自动生效。source 让当前会话立即生效不用重新登录。写这一行时注意用单引号包住整个内容避免 $PATH 在 echo 时被当前 shell 提前展开。如果用了双引号写入文件的内容会变成 export PATH/opt/cmake-3.27.6/bin:/usr/bin:/bin 这样的固定值后面所有路径都会丢失。提示非交互 shell 不读 ~/.bashrc。如果某个部署脚本在 cron 里跑 cmake要在脚本头部重新 source /etc/profile 或显式 export PATH否则每次都会用 /usr/bin/cmake。4.4 全局配置让 root 和所有用户都能用sudo tee /etc/profile.d/cmake-3.27.6.sh /dev/null EOF export PATH/opt/cmake-3.27.6/bin:$PATH EOF逻辑说明/etc/profile.d 下的 .sh 文件会在用户登录时被全局加载适合一台多人共用的构建机。同样的单引号 EOF 写法保证了 $PATH 不会被提前展开写入的是原始字符串。这个方案的缺点是当前已经打开的终端不会自动生效需要重新登录或手动 source。另一种思路是把 PATH 写进 /etc/environment但那个文件不支持变量展开写起来容易出歧义所以我一般不推荐。4.5 多版本切换直接用绝对路径比改 PATH 更可靠# 临时用旧版本构建 /usr/bin/cmake --version # 用新版本构建 /opt/cmake-3.27.6/bin/cmake --version当服务器上同时存在两个 CMake 版本我一般不在全局反复改 PATH而是在项目构建命令里直接用绝对路径。这样每个项目的构建日志里能直接看出用的是哪个 CMake避免某个脚本 source 了旧环境后把版本悄悄切回去。如果你确实需要一键切换可以在 ~/.bashrc 里定义两个函数use_cmake327() { export PATH/opt/cmake-3.27.6/bin:$PATH; hash -r; } use_cmake316() { export PATH/opt/cmake-3.16.3/bin:$PATH; hash -r; }这种切换是会话级的只在当前终端生效不会污染全局环境。函数名自己起顺手就行。4.6 验证当前会话真正生效的版本type -a cmake which cmake cmake --versiontype -a 会列出 bash 能找到的所有 cmake 候选路径顺序就是 PATH 中的查找顺序。看输出里 /opt/cmake-3.27.6/bin/cmake 是否排在 /usr/bin/cmake 前面。这一步相当于给环境做体检比单独看 --version 更可靠。5. 安装避坑5 个高频翻车现场与排查方法5.1 直接执行 .sh 报 Permission denied现象./cmake-3.27.6-linux-x86-64.sh 执行时报 Permission denied。原因下载下来的文件没有 x 执行权限或者所在分区以 noexec 选项挂载。这是最简单的坑但踩的人不少。解决用 /bin/sh 直接执行不依赖文件权限或者先 chmod x 再执行。# 方法一用 sh 执行不需要 x 权限 /bin/sh cmake-3.27.6-linux-x86-64.sh --prefix/opt/cmake-3.27.6 --skip-license --exclude-subdir # 方法二加执行权限再运行 chmod x cmake-3.27.6-linux-x86-64.sh ./cmake-3.27.6-linux-x86-64.sh --prefix/opt/cmake-3.27.6 --skip-license --exclude-subdir我一般直接用 /bin/sh。加 chmod 虽然也行但会在共享目录里留下一个可执行文件安全策略严格的环境可能不喜欢。5.2 装完 cmake --version 还是老版本现象已经按第 3 章的步骤执行完成新开终端后 cmake --version 仍然显示 3.20.5 之类的旧版本。原因PATH 顺序没有改变或者 bash 缓存了旧命令路径。解决hash -r type -a cmake cmake --versiontype -a 能看到查找排序。如果 /opt/cmake-3.27.6/bin/cmake 排在后面说明 export 没有写进配置文件或者刚改完还没 source。如果 type -a 里只有 /usr/bin/cmake说明 PATH 配置完全没生效回去检查 .bashrc 那行有没有被引号问题吃掉。5.3 忘加 --exclude-subdirbin 目录找不着现象安装成功提示也有但 /opt/cmake-3.27.6/bin/cmake 不存在看起来像装了个空目录。原因脚本默认在 prefix 下保留了包含版本号的顶层目录安装内容实际在 /opt/cmake-3.27.6/cmake-3.27.6-linux-x86-64/bin 下。解决先确认实际目录然后干脆重装一次加上 --exclude-subdir。# 确认实际目录位置 find /opt/cmake-3.27.6 -name cmake -type f # 重装加上 --exclude-subdir sudo rm -rf /opt/cmake-3.27.6 sudo /bin/sh cmake-3.27.6-linux-x86-64.sh --prefix/opt/cmake-3.27.6 --skip-license --exclude-subdir不要为了省事去为深层目录做软链接因为后续 PATH、卸载都会混乱。错误发现得早重装成本最低。5.4 sudo 执行 cmake 时 command not found现象普通用户下 cmake -version 正常sudo cmake -version 却提示 command not found。原因多数发行版 sudo 默认启用 secure_path只保留系统目录/opt/cmake-3.27.6/bin 不在白名单里。sudo 环境下 PATH 被过滤普通用户的环境变量不生效。解决在 sudoers 配置里把 /opt/cmake-3.27.6/bin 加进 secure_path。sudo visudo -f /etc/sudoers.d/cmake # 写入一行 # Defaults secure_path/opt/cmake-3.27.6/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin改完后重新打开终端或执行 sudo -l 检查。不要在没确认语法正确的情况下直接退出 visudo否则可能把 sudo 配置弄坏到时候要单用户模式才能救回来。5.5 老系统上执行报 GLIBC_2.XX not found现象运行 /opt/cmake-3.27.6/bin/cmake --version 时提示 error while loading shared libraries或者直接说找不到 GLIBC_2.17、GLIBC_2.18 这类符号。原因CMake 官方预编译二进制在较新的系统环境里链接它要求的 GLIBC 版本高于当前这台老服务器提供的版本。这与安装脚本本身无关是系统 libc 太旧。解决# 先看服务器实际的 GLIBC 版本 ldd --version | head -1如果系统确实达不到要求两个方向。一是换一台系统较新的构建机二是用源码编译 CMake。源码编译出来的二进制和当前系统 libc 兼容不再依赖官方二进制的高版本要求编译时间虽然长一些但在老服务器上是唯一的出路。提前在第 2 章用 ldd --version 检查就能避免装到一半才发现的尴尬。6. 进阶多版本共存与无人值守安装的脚本化习惯6.1 按项目固定 CMake 版本而不是全局切来切去我现在的习惯是每个项目把 CMake 版本写进构建文档要么锁在 CMakeLists.txt 的 cmake_minimum_required要么在 CI 配置里固定调用 /opt/cmake-3.27.6/bin/cmake 这条绝对路径。两个版本共存不需要任何魔法分别装到两个目录就可以。# 旧项目需要的版本比如 3.16.3 sudo /bin/sh cmake-3.16.3-linux-x86-64.sh --prefix/opt/cmake-3.16.3 --skip-license --exclude-subdir # 新项目用 3.27.6 sudo /bin/sh cmake-3.27.6-linux-x86-64.sh --prefix/opt/cmake-3.27.6 --skip-license --exclude-subdir # 构建时指定绝对路径 /opt/cmake-3.27.6/bin/cmake -S . -B build为什么要这么干遇到老项目升级构建环境时新 CMake 可能因为策略变化把原来的警告变成错误直接导致编译失败。用绝对路径固定版本构建日志里一眼能看出是哪个 CMake 在干活排查时间能省下一大半。6.2 无人值守安装脚本把整个安装过程固化成脚本是我在 CI 和批量服务器上最常用的做法#!/bin/bash set -euo pipefail CMAKE_ROOT/opt/cmake-3.27.6 CMAKE_SHcmake-3.27.6-linux-x86-64.sh if [ ! -x $CMAKE_ROOT/bin/cmake ]; then wget -O /tmp/$CMAKE_SH 你的下载源里 $CMAKE_SH 的完整地址 wget -O /tmp/CMakeSHA256.txt 你的下载源里校验文件的完整地址 (cd /tmp sha256sum --check --ignore-missing CMakeSHA256.txt) sudo mkdir -p $CMAKE_ROOT sudo /bin/sh /tmp/$CMAKE_SH --prefix$CMAKE_ROOT --skip-license --exclude-subdir fi $CMAKE_ROOT/bin/cmake --build buildset -euo pipefail 保证任何一步失败脚本立即退出sha256sum 校验不通过不会继续执行。装过以后 [ -x $CMAKE_ROOT/bin/cmake ] 为真直接跳过安装整个脚本具备幂等性跑多少次都是同一个结果。6.3 用一个最小项目验证安装是否真的可用版本号可以骗人构建结果骗不了人。装完 CMake 后我习惯先跑一个最小项目验证整套链路mkdir -p /tmp/cmake-demo cd /tmp/cmake-demo cat CMakeLists.txt EOF cmake_minimum_required(VERSION 3.16) project(demo C) add_executable(demo main.c) EOF echo int main(void) { return 0; } main.c /opt/cmake-3.27.6/bin/cmake -S . -B build /opt/cmake-3.27.6/bin/cmake --build build这个最小项目同时覆盖 configure 和 build 两个动作能验证 CMake 本身、生成器、编译器三者的配合是否正常。如果这里能过再回去跑真实项目错误会少很多。我的习惯是装完任何工具链第一件事不是盯着版本号看而是拿最小工程跑一遍完整构建。版本号可以骗人构建结果骗不了人。希望这些细节能帮你把 CMake 3.27.6 的安装从玄学变成稳定可复现的操作。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
