Linux下C++项目Makefile编写指南：从基础到进阶

1. 项目背景与核心需求

在Linux环境下开发C/C++项目时，Makefile是管理编译流程的标配工具。最近在Ubuntu上开发一个需要链接第三方库的小型项目时，我发现很多新手（包括当年的我自己）最头疼的就是如何正确编写链接库的Makefile规则。那些自动生成工具虽然方便，但隐藏了太多细节，当需要自定义编译选项或解决链接错误时，反而增加了调试难度。

这个教程将手把手演示如何从零开始，为一个依赖第三方数学库的C++项目编写Makefile。我们会先创建一个最简单的版本，然后逐步添加头文件搜索路径、库文件链接、调试符号等实用功能。最终得到的Makefile虽然只有20行左右，但包含了实际开发中最常用的配置模式。

2. 基础环境准备

2.1 安装必备工具链

在Ubuntu 22.04 LTS上，首先确保安装了基本的编译工具：

bash复制sudo apt update
sudo apt install build-essential gdb

验证g++版本（本文基于g++ 11.3.0）：

bash复制g++ --version

2.2 示例项目结构

创建如下目录结构作为演示项目：

code复制math_demo/
├── include/
│   └── calculator.h
├── src/
│   ├── calculator.cpp
│   └── main.cpp
└── Makefile

其中calculator.h声明了一个使用数学库的函数：

cpp复制// calculator.h
#pragma once
double calculate_hypotenuse(double a, double b);

对应的实现文件calculator.cpp：

cpp复制// calculator.cpp
#include "calculator.h"
#include <cmath>

double calculate_hypotenuse(double a, double b) {
    return sqrt(pow(a, 2) + pow(b, 2));
}

主程序main.cpp：

cpp复制// main.cpp
#includ