CMake进阶：Ninja环境搭建与加速项目构建

目录

1.引入Ninja的原因

2.Ninja 环境搭建（跨平台）

2.1.Linux系统安装

2.2.macOS 系统

2.3.Windows 系统

2.4.源码编译安装（通用方案）

3.Ninja 与构建系统配合：以 CMake 为例

4.加速构建的关键技巧

5.Ninja 与 Make 构建速度对比

6.项目构建过程中遇到的问题

7.总结

相关链接

1.引入Ninja的原因

        Ninja 是一款由 Google 开发的轻量、高速的构建系统，专注于 “快速执行构建”，尤其擅长处理大型项目的频繁增量构建。相比传统的 Make，Ninja 启动速度更快、并行编译效率更高，是频繁迭代开发场景（如 C++/Rust 项目）的理想选择。

         Ninja 加速构建的核心原因：

1.极简设计：Ninja 的构建文件（.ninja）语法简单，仅包含必要的依赖和命令，解析速度远快于 Makefile（避免 Make 的复杂语法和冗余处理）。

2.高效并行：默认充分利用多核 CPU，并行任务调度更智能（比 Make 更精准地控制并行数，减少资源竞争）。

3.增量构建优化：对文件修改的检测和依赖跟踪更高效，仅重新编译受影响的文件，避免不必要的重建。

4.无冗余开销：启动时几乎无额外计算（如 Make 会重新解析整个 Makefile），适合频繁构建（如开发中 “改一行代码就重建” 的场景）。

2.Ninja 环境搭建（跨平台）

Ninja 支持 Windows、Linux、macOS，安装方式简单，优先推荐通过包管理器或官方二进制包安装。

2.1.Linux系统安装

通过包管理器安装（推荐）：

Ubuntu/Debian：

sudo apt update && sudo apt install ninja-build

Fedora/RHEL：

sudo dnf install ninja-build

Arch Linux：

sudo pacman -S ninja

验证安装：

ninja --version  # 输出版本号即成功（如 1.11.1）

2.2.macOS 系统

通过 Homebrew 安装（推荐）：

brew install ninja

验证：

ninja --version

2.3.Windows 系统

Windows 需手动配置 PATH，推荐以下两种方式：

方式 1：包管理器安装（需先安装 Chocolatey 或 Scoop）：

Chocolatey：

    choco install ninja -y

    Scoop：

    scoop install ninja

    方式 2：手动下载二进制：

    1. 从 Ninja 官网 下载最新 Windows 二进制包（如 ninja-win.zip）。
    2. 解压得到 ninja.exe，将其所在目录（如 C:\tools\ninja）添加到系统环境变量 PATH。
    3. 重启终端，执行 ninja --version 验证。

    2.4.源码编译安装（通用方案）

    若上述方法不适用，可从源码编译（需 Python 3 环境）：

    构造Ninja可使用CMake或python，需要先安装re2c：

    1.安装re2c。下载地址：http://re2c.org/index.html

    tar -xvzf re2c-1.0.3.tar.gz   # 解压
cd re2c-1.0.3/                # 进入目录
autoreconf -i -W all          # 生成configure（若无configure时用）
./configure                   # 配置编译选项
make                          # 编译
sudo make install             # 安装（需管理员权限）

    2.re2c安装成功之后开始Ninja安装:

    # 克隆源码
git clone https://github.com/ninja-build/ninja.git
cd ninja# 编译（生成 ninja 二进制文件）
python3 configure.py --bootstrap# 安装（Linux/macOS 为例，Windows 直接使用生成的 ninja.exe）
sudo cp ninja /usr/local/bin/

    3.Ninja 与构建系统配合：以 CMake 为例

    Ninja 本身不直接处理项目配置（如依赖、编译选项），通常由 CMake、Meson 等工具生成 .ninja 构建文件，再通过 Ninja 执行构建。以下以最常用的 CMake 为例说明。

    1.生成 Ninja 构建文件

    在 CMake 项目中，通过 -G "Ninja" 指定生成 Ninja 格式的构建文件：

    # 创建构建目录（推荐 out-of-source 构建，避免污染源码）
mkdir build && cd build# 生成 Ninja 构建文件（替代默认的 Makefile）
cmake -G "Ninja" ..  # .. 指向源码根目录（含 CMakeLists.txt）

    执行后，build 目录下会生成 build.ninja（主构建文件）、rules.ninja（编译规则）等，后续通过 Ninja 构建。

    2.执行构建

    生成构建文件后，直接用 ninja 命令启动构建：

    # 构建默认目标（如 all 目标）
ninja# 构建指定目标（如生成可执行文件 myapp）
ninja myapp# 清理构建产物
ninja clean# 显示详细编译命令（调试用）
ninja -v

    4.加速构建的关键技巧

    Ninja 本身已足够高效，但结合以下技巧可进一步提升构建速度，尤其适合大型项目。

    1.最大化并行编译

    Ninja 默认根据 CPU 核心数自动并行执行任务（类似 make -j$(nproc)），但可手动指定更优的并行数（避免过多任务导致内存瓶颈）：

    # 查看 CPU 核心数（Linux/macOS）
nproc  # 输出如 8（8 核）# 指定 8 个并行任务（根据核心数调整，通常等于或略大于核心数）
ninja -j 8

    注意：并行数并非越大越好，若项目编译需要大量内存（如链接大型二进制），过度并行可能导致内存不足，需根据实际硬件调整。

    2.配合编译缓存（ccache/sccache）

    编译缓存工具（如 ccache 或 sccache）可缓存编译产物，重复编译相同代码时直接复用，大幅减少编译时间。需在 CMake 中配置编译器路径为缓存工具：

    # 安装 ccache（Linux 为例）
sudo apt install ccache# 生成 Ninja 构建文件时，指定 C/C++ 编译器为 ccache 包装的 clang/gcc
cmake -G "Ninja" \-DCMAKE_C_COMPILER=ccache \-DCMAKE_CXX_COMPILER=ccache \-DCMAKE_C_COMPILER_LAUNCHER=ccache \-DCMAKE_CXX_COMPILER_LAUNCHER=ccache \..

    后续 ninja 构建时，ccache 会自动缓存 .o 目标文件，重复修改少量代码时，编译时间可减少 50% 以上。

    3.优化增量构建

    Ninja 对增量构建的优化是其核心优势之一，但需注意：

    • 确保项目的 CMakeLists.txt 正确设置依赖（如 target_link_libraries、target_include_directories），避免不必要的文件被标记为 “需要重建”。
    • 避免在构建目录中手动修改文件，防止 Ninja 的依赖跟踪失效。

    4.使用 ninja -t 调试构建问题

    若构建异常（如重复编译、依赖错误），可通过 Ninja 的调试命令分析：

    # 列出所有目标
ninja -t targets# 查看目标依赖链（如 myapp 依赖哪些文件）
ninja -t graph myapp | dot -Tpng -o myapp_deps.png  # 需要安装 graphviz# 检查哪些文件会触发目标重建
ninja -t dependents myapp.cpp

    5.结合 Clang 或 Mold 链接器

    链接阶段（尤其大型项目）往往是构建瓶颈，可配合更快的链接器：

    • Clang 链接器（lld）：比 GNU ld 更快，CMake 中指定 CMAKE_EXE_LINKER_FLAGS=-fuse-ld=lld。
    • Mold 链接器：速度远超 lld，适合超大项目，配置 CMAKE_EXE_LINKER_FLAGS=-fuse-ld=mold。

    配置方式：

    cmake -G "Ninja" \-DCMAKE_EXE_LINKER_FLAGS="-fuse-ld=lld" \-DCMAKE_SHARED_LINKER_FLAGS="-fuse-ld=lld" \..

    5.Ninja 与 Make 构建速度对比

    以之前的Fast-DDS为例，在麒麟V10桌面虚拟机化境下，对比相同配置下的构建时间：

    通信中间件 Fast DDS(一) ：编译、安装和测试_fast dds 安装-CSDN博客

    构建场景Make（命令make）Ninja（命令ninja）加速比例
    全量构建（首次）9分25秒3分44秒61.4%
    增量构建（改 1 文件）未测试未测试未知

    可见，Ninja 在构建中优势很明显，这对频繁调试的开发场景至关重要。

    6.项目构建过程中遇到的问题

    1.在windows命令行构建报错

    解决方法：

    在 Visual Studio 开发者命令提示符（而非普通 PowerShell）中运行 CMake，步骤：

    1) 开始菜单找到 “Developer Command Prompt for Visual Studio 2022” 并打开；

    2) 进入项目 build 目录，执行：

    cmake -G "Ninja" ..

    （原理：普通终端未加载 MSVC 编译器环境变量，开发提示符会自动配置 CL.exe 路径。）

    2.检查架构一致性（32 位 vs 64 位）

    你的编译日志显示当前使用的是 32 位编译器（Hostx86/x86/cl.exe），而 vcpkg 安装的依赖（如 asio_x64-windows）是 64 位版本，可能存在架构不匹配：

    • 若 fastcdr 安装的是 64 位版本，而编译器是 32 位，会导致查找失败。
    • 解决：使用 64 位 VS 开发者命令提示符（如 “x64 Native Tools Command Prompt for VS 2022”），并确保 fastcdr 是 64 位版本。

    7.总结

    Ninja 是提升项目构建效率的 “利器”，其核心价值在于快速启动、高效并行和精准增量构建。通过以下步骤可充分发挥其优势：

    1. 按系统需求安装 Ninja（包管理器或二进制包最便捷）；
    2. 用 CMake 生成 Ninja 构建文件（-G "Ninja"）；
    3. 结合 -j 调整并行数、ccache 缓存编译产物、快速链接器（lld/mold）进一步加速；
    4. 用 ninja -t 命令调试构建依赖问题。

    对于需要频繁迭代的大型项目，Ninja 可显著减少构建等待时间，提升开发效率。

    相关链接

    • CMake 官网 CMake - Upgrade Your Software Build System
    • CMake 官方文档：CMake Tutorial — CMake 4.1.0 Documentation
    • CMake 源码：https://github.com/Kitware/CMake
    • CMake 源码：https://gitlab.kitware.com/cmake/
    • 中文版基础介绍: CMake 入门实战 | HaHack
    • wiki: https://gitlab.kitware.com/cmake/community/-/wikis/Home
    • Modern CMake 简体中文版:  Introduction · Modern CMake

    本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
    如若转载，请注明出处：http://www.pswp.cn/bicheng/94255.shtml
    繁体地址，请注明出处：http://hk.pswp.cn/bicheng/94255.shtml

    如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

    相关文章

    开发避坑指南(35)：mybaits if标签test条件判断等号=解析异常解决方案

    开发避坑指南(35)：mybaits if标签test条件判断等号=解析异常解决方案

    异常信息 org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.builder.BuilderException: The expression orderInfo.idList evaluated to a null value.报错语句 <if test"orderInfo.queryFlag ! null and orderInfo.queryFlag sett…
    阅读更多...
    GitCode 疑难问题诊疗：全面指南与解决方案

    GitCode 疑难问题诊疗：全面指南与解决方案

    引言 在软件开发的动态领域中&#xff0c;GitCode 作为一款强大的分布式版本控制系统&#xff0c;已然成为团队协作与项目管理的基石。它赋予开发者高效管理代码版本、轻松实现并行开发以及顺畅协同合作的能力。然而&#xff0c;如同任何复杂的技术工具&#xff0c;在 GitCode…
    阅读更多...
    使用 JS 渲染页面并导出为PDF 常见问题与修复

    使用 JS 渲染页面并导出为PDF 常见问题与修复

    本文直击两个最常见的导出痛点&#xff0c;并给出可直接落地的诊断 修复方案&#xff08;适用于 html2canvas jsPDF ECharts/自绘 canvas 场景&#xff09;。 问题清单 问题 A&#xff1a;导出后图表模糊&#xff0c;线条与文字不清晰&#xff08;低分辨率&#xff09;。问题…
    阅读更多...
    【Java后端】【可直接落地的 Redis 分布式锁实现】

    【Java后端】【可直接落地的 Redis 分布式锁实现】

    可直接落地的 Redis 分布式锁实现&#xff1a;包含最小可用版、生产可用版&#xff08;带 Lua 原子解锁、续期“看门狗”、自旋等待、可重入&#xff09;、以及基于注解AOP 的无侵入用法&#xff0c;最后还给出 Redisson 方案对比与踩坑清单。一、设计目标与约束 获取锁&#x…
    阅读更多...
    数据结构 -- 链表--双向链表的特点、操作函数

    数据结构 -- 链表--双向链表的特点、操作函数

    双向链表的操作函数DouLink.c#include "DouLink.h" #include <stdio.h> #include <stdlib.h> #include <string.h>/*** brief 创建一个空的双向链表* * 动态分配双向链表管理结构的内存&#xff0c;并初始化头指针和节点计数* * return 成功返回指…
    阅读更多...
    Wireshark获取数据传输的码元速率

    Wireshark获取数据传输的码元速率

    一、Wireshark的物理层参数 Wireshark主界面可以看到数据发送时刻和长度&#xff1a; 这个时刻是Wireshark完整获取数据包的时刻&#xff0c;实际上就是结束时刻。 需要知道的是&#xff1a; Wireshark工作在数据链路层及以上&#xff0c;它能解码 以太网帧 / IP 包 / TCP…
    阅读更多...
    11.1.3 完善注册登录，实现文件上传和展示

    11.1.3 完善注册登录，实现文件上传和展示

    1、完善注册/登录 1. 涉及的数据库表单&#xff1a;user_info 2. 引用MySQL线程池&#xff0c;Redis线程池 3. 完善注册功能 4. 完善登录功能 2.1 涉及的数据库表单&#xff1a;user_info 重新创建数据库 #创建数据库 DROP DATABASE IF EXISTS 0voice_tuchuang;CREATE D…
    阅读更多...
    【Linux文件系统】目录结构

    【Linux文件系统】目录结构

    有没有刚进入Linux世界时&#xff0c;对着黑乎乎的终端&#xff0c;输入一个 ls / 后&#xff0c;看着蹦出来的一堆名字 like bin, etc, usr&#xff0c;感觉一头雾水&#xff0c;像是在看天书&#xff1f; 别担心&#xff0c;你不是一个人。Linux的文件系统就像一个超级有条理…
    阅读更多...
    螺旋槽曲面方程的数学建模与偏导数求解

    螺旋槽曲面方程的数学建模与偏导数求解

    螺旋槽曲面的数学描述 在钻头设计和机械加工领域，螺旋槽的几何建模至关重要。螺旋槽通常由径向截形绕轴做螺旋运动形成，其数学模型可通过参数方程和隐函数方程两种方式描述。 设螺旋槽的径向截形方程为： y=f(z)y = f(z)y=f(z) x=xcx = x_cx=xc​ 其中 xcx_cxc​ 为常数，…
    阅读更多...
    线性回归：机器学习中的基石

    线性回归：机器学习中的基石

    在机器学习的众多算法中&#xff0c;线性回归无疑是最基础也是最常被提及的一种。它不仅在统计学中占有重要地位&#xff0c;而且在预测分析和数据建模中也发挥着关键作用。本文将深入探讨线性回归的基本概念、评估指标以及在实际问题中的应用&#xff0c;并通过一个模拟的气象…
    阅读更多...
    编程刷题-资料分发1 图论/DFS

    编程刷题-资料分发1 图论/DFS

    P2097 资料分发 1 题目描述 有一些电脑&#xff0c;一部分电脑有双向数据线连接。 如果一个电脑得到数据&#xff0c;它可以传送到的电脑都可以得到数据。 现在&#xff0c;你有这个数据&#xff0c;问你至少将其输入几台电脑&#xff0c;才能使所有电脑得到数据。 输入格式 第…
    阅读更多...
    RabbitMQ：延时消息（死信交换机、延迟消息插件）

    RabbitMQ：延时消息（死信交换机、延迟消息插件）

    目录一、死信交换机【不推荐】二、延迟消息插件【推荐】2.1 安装插件【Linux】2.2 安装插件【Windows】2.3 如何使用延时消息&#xff1a;生产者发送消息时指定一个时间&#xff0c;消费者不会立刻收到消息&#xff0c;而是在指定时间之后才收到消息。 延时任务&#xff1a;设置…
    阅读更多...
    动学学深度学习05-深度学习计算

    动学学深度学习05-深度学习计算

    动学学深度学习pytorch 参考地址&#xff1a;https://zh.d2l.ai/ 文章目录动学学深度学习pytorch1-第05章-深度学习计算1. 层&#xff08;Layer&#xff09;与块&#xff08;Block&#xff09;1.1 什么是深度学习中的“层”&#xff1f;1.2 什么是“块”&#xff08;Block&…
    阅读更多...
    智慧工厂烟雾检测：全场景覆盖与精准防控

    智慧工厂烟雾检测：全场景覆盖与精准防控

    智慧工厂烟雾检测&#xff1a;构建工业安全的智能防线&#xff08;所有图片均为真实项目案例&#xff09;在工业4.0时代&#xff0c;智慧工厂通过物联网、人工智能与大数据技术的深度融合&#xff0c;实现了生产流程的数字化与智能化。然而&#xff0c;工厂环境中的火灾隐患始终…
    阅读更多...
    @JsonIgnoreProperties注解详解

    @JsonIgnoreProperties注解详解

    JsonIgnoreProperties是 Jackson 库中的一个重要注解&#xff0c;用于在 JSON 序列化&#xff08;对象转 JSON&#xff09;和反序列化&#xff08;JSON 转对象&#xff09;过程中​​控制属性的可见性​​。它提供了更高级别的属性忽略能力&#xff0c;特别适合处理复杂场景。一…
    阅读更多...
    红酒数据集预处理实战：缺失值处理的 5 种打开方式，从入门到进阶一步到位

    红酒数据集预处理实战：缺失值处理的 5 种打开方式，从入门到进阶一步到位

    在数据分析与建模流程中&#xff0c;缺失值处理是数据预处理阶段的关键步骤&#xff0c;直接影响后续模型的准确性与稳定性。本文以红酒数据集为研究对象&#xff0c;详细介绍如何通过基础统计方法&#xff08;均值、中位数、众数&#xff09;、完整案例分析&#xff08;CCA&am…
    阅读更多...
    Node.js 开发 JavaScript SDK 包的完整指南（AI）

    Node.js 开发 JavaScript SDK 包的完整指南（AI）

    一、核心概念SDK 包定义 专为特定服务/平台封装的工具库&#xff0c;提供标准化 API 调用、错误处理、类型声明等功能。示例&#xff1a;支付宝 SDK、AWS SDK、微信小程序 SDK。技术栈选择 语言&#xff1a;JavaScript/TypeScript&#xff08;推荐 TS&#xff0c;便于类型提示&…
    阅读更多...
    Redis实战-基于Session实现分布式登录

    Redis实战-基于Session实现分布式登录

    1.流程分析1.1发送短信验证码提交手机号的时候要进行校验手机号&#xff0c;校验成功才会去生成验证码&#xff0c;将验证码保存到session&#xff0c;发生他把这部分那。1.2短信验证码登录/注册如果提交手机号和验证码之后&#xff0c;校验一致才进行根据手机号查询用户&#…
    阅读更多...
    疯狂星期四文案网第47天运营日记

    疯狂星期四文案网第47天运营日记

    网站运营第47天&#xff0c;点击观站&#xff1a; 疯狂星期四 crazy-thursday.com 全网最全的疯狂星期四文案网站 运营报告 今日访问量 今日搜索引擎收录情况 必应现在是边收录边k页面 百度快倒闭 网站优化点 完善工作流&#xff0c;全面实现文案自动化采集&#xff0c;se…
    阅读更多...
    Vue生命周期以及自定义钩子和路由

    Vue生命周期以及自定义钩子和路由

    Vue生命周期常用的onMounted挂载后执行和onUnmounted卸载前以及onupdated更新后实际上用react对比就是useEffect&#xff0c;而且挂载顺序也是子组件先于父组件然后往外的栈结构&#xff0c;先进后出。1.Vue的生命周期<template><h2>当前求和为{{ sum }}</h2>…
    阅读更多...
    最新文章

    Copyright @ 2022~2023