CMake入门macOS安装配置教程

云枫君_5397

云枫君_5397

2026-08-09

479人浏览

原创

答案是PATH环境变量未包含CMake命令路径。根本原因是macOS终端依赖PATH查找命令,而DMG安装的CMake命令位于/Applications/CMake.app/Contents/bin/,该路径未被自动加入PATH;Homebrew安装虽自动配置路径,但若PATH顺序不当或配置文件未重载,仍会导致command not found。

cmake入门macos安装配置教程

Mac 上输入 cmake --version 报错 command not found,不是没装好,而是终端根本找不到它——CMake.app 里的命令行工具默认不在系统 PATH 里。

Homebrew 安装:最省心,但得先装 Homebrew

这是目前 macOS 上最主流、最不容易出问题的方式。Homebrew 自动把 cmake 放进 /opt/homebrew/bin(M1/M2/M3)或 /usr/local/bin(Intel),且该路径天然在 PATH 前段。

  • 先确认 Homebrew 是否已装:which brew,有输出就继续;没有就跑官方安装脚本:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • 更新索引:brew update
  • 装 CMake:brew install cmake
  • 验证:cmake --version,看到版本号即成功

注意:如果之前手动改过 PATH,又恰好把 /usr/local/bin 或 /opt/homebrew/bin 排到了后面,可能被其他旧版 cmake 覆盖。用 which cmake 看实际调用的是哪个路径。

DMG 拖拽安装后手动加 PATH:适合需要 GUI 或离线环境

从官网下载的 .dmg 文件本质是 CMake.app,命令行工具藏在 /Applications/CMake.app/Contents/bin/ 下。不加 PATH,终端永远找不到它。

  • 下载 macOS Universal DMG(支持 M1/M2/M3 和 Intel),挂载后拖进 /Applications
  • 查 shell 类型:echo $SHELL,macOS Catalina 及以后默认是 zsh,对应配置文件是 ~/.zshrc;老系统可能是 bash,用 ~/.bash_profile
  • 追加路径:echo 'export PATH="/Applications/CMake.app/Contents/bin:$PATH"' >> ~/.zshrc
  • 生效配置:source ~/.zshrc
  • 验证:cmake --version

常见坑:写错路径(比如漏掉 /Contents/bin)、编辑了错误的 shell 配置文件(zsh 用户改了 .bash_profile)、忘记 source。可以用 echo $PATH | grep CMake 快速确认路径是否已生效。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限

下载

源码编译安装:可控性强,但容易卡在依赖或权限上

适用于需要定制构建选项(比如禁用 Qt GUI、启用测试模块)、调试 CMake 本身,或系统路径受限时。默认装到 /usr/local,该路径通常已在 PATH 中。

  • 先装 Xcode 命令行工具:xcode-select --install,否则 clang 和 make 都没有
  • 下载 .tar.gz 源码包,解压后进入目录
  • 执行:./bootstrap --prefix=/usr/local --parallel=$(sysctl -n hw.ncpu)
  • 编译:make -j$(sysctl -n hw.ncpu)
  • 安装:sudo make install

关键点:macOS 的 SIP 机制保护 /usr,所以不能用 --prefix=/usr;/usr/local 是安全选择。如果 bootstrap 报错缺 Python 或 ncurses,说明系统缺少基础依赖,需先 brew install python ncurses。

三种方式互不干扰,但优先级取决于 shell 加载顺序——越靠前的 PATH 条目越先被匹配。如果你同时用了 Homebrew 和 DMG 方式,又没清理旧路径,which cmake 返回的结果可能不是你预期的那个。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

cmake cmake入门教程 macos

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
macOS怎么切换用户账户
macOS怎么切换用户账户

在 macOS 系统中,可通过多种方式切换用户账户。如点击苹果图标选择 “系统偏好设置”,打开 “用户与群组” 进行切换;或启用快速用户切换功能,通过菜单栏或控制中心的账户名称切换;还能使用快捷键 “Control+Command+Q” 锁定屏幕后切换。

2025.05.09

5044

14

C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

2025.10.17

7086

15

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.23

1651

14

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

2025.12.13

374

18

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

20

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

20

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

0

10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

120

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

60

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
LLVM CMake构建指南
LLVM CMake构建指南

共0课时 | 0人学习

LLVM入门手册
LLVM入门手册

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习