Mac下gcc/clang/g++编译C++项目出现arm64未定义符号链接错误

问题详情 #

在Mac平台使用g++/clang编译运行main.cpp时出现链接错误，项目相关信息如下：

项目文件代码 #

random/random.h

#include <cmath>
#include <cstdio>
#include <cstdlib>
#include <ctime>

void initialize();
float randomFloat(int, int, int);

random/random.cpp

#include "random.h"

void initialize() { srand(time(NULL)); }

float randomFloat(int min, int max, int p) {
  int intPart = rand() % (max - (min - 1)) + min;
  if (intPart == max) {
    intPart--;
  }
  float decimal = (float)(rand() % (int)pow(10, p)) / pow(10, p);
  return intPart + decimal;
}

util/util.h

#include <iostream>

int askInteger(const char *, bool);

util/util.cpp

#include "util.h"

using namespace std;

int askInteger(const char *message, bool onlyPositive) {
  int number;
  if (onlyPositive) {

    while (cout << "Type a correct " << message << ": ",
           !(cin >> number) || number < 0) {
      cerr << "Input error, try again. \n";
      if (cin.fail()) {
        cin.clear();
        cin.ignore();
      }
    }

  } else {
    while (cout << "Type a correct " << message << ": ", !(cin >> number)) {
      cerr << "Input error, try again. \n";
      if (cin.fail()) {
        cin.clear();
        cin.ignore();
      }
    }
  }
  return number;
}

main.cpp

#include "random/random.h"
#include "util/util.h"

using namespace std;

int main() {
  int n, min, max, p;

  n = askInteger("numbers quantity", true);
  p = askInteger("precession", true);
  min = askInteger("min value (included)", false);
  max = askInteger("max value (included)", false);

  while (max <= min) {
    cout << "max value should be greather than " << min << "\n";
    max = askInteger("max value (included)", false);
  }

  initialize();

  for (int i = 0; i < n; i++) {
    cout << randomFloat(min, max, p) << "\n";
  }
}

编译报错信息 #

Undefined symbols for architecture arm64:
  "askInteger(char const*, bool)", referenced from:
      _main in main-2552a5.o
  "initialize()", referenced from:
      _main in main-2552a5.o
  "randomFloat(int, int, int)", referenced from:
      _main in main-2552a5.o
ld: symbol(s) not found for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

VSCode执行的编译命令 #

cd "/Users/user/Downloads/Random-Numbers/" && g++ main.cpp -o main && "/Users/user/Downloads/Random-Numbers/"main

项目结构 #

项目根目录包含两个子目录：

• random：存放random.h和random.cpp
• util：存放util.h和util.cpp

已尝试的无效操作 #

• gcc *.h
• gcc -c *.h
• g++ *.cpp
• g++ -o *.cpp
• g++ -c *.cpp

问题原因 #

链接错误的核心是：编译时只处理了main.cpp，没有将子目录中的random.cpp和util.cpp纳入编译链接流程，导致编译器找不到函数的实现代码。另外，你尝试的命令存在误区：

• 头文件不需要单独编译，仅需在源文件中引用即可
• *.cpp通配符只会匹配当前目录的文件，子目录中的源文件不会被选中

解决方法 #

方法一：直接指定所有源文件编译 #

在项目根目录执行以下命令，明确列出所有需要编译的.cpp文件：

g++ main.cpp random/random.cpp util/util.cpp -o main

编译完成后运行程序：

./main

方法二：分步编译再链接 #

先将每个源文件编译为目标文件（.o），再统一链接：

1. 编译各个源文件：

g++ -c main.cpp -o main.o
g++ -c random/random.cpp -o random.o
g++ -c util/util.cpp -o util.o

2. 链接所有目标文件生成可执行文件：

g++ main.o random.o util.o -o main

3. 运行程序：

./main

方法三：使用Makefile自动化编译（推荐） #

创建Makefile简化后续编译流程，在项目根目录新建Makefile文件，内容如下：

CC = g++
CFLAGS = -Wall -std=c++11
SRCS = main.cpp random/random.cpp util/util.cpp
OBJS = $(SRCS:.cpp=.o)
TARGET = main

all: $(TARGET)

$(TARGET): $(OBJS)
	$(CC) $(CFLAGS) $(OBJS) -o $(TARGET)

%.o: %.cpp
	$(CC) $(CFLAGS) -c $< -o $@

clean:
	rm -f $(OBJS) $(TARGET)

之后只需在根目录执行以下命令即可完成编译：

make

执行make clean可清理生成的目标文件和可执行文件。

内容的提问来源于stack exchange，提问作者lxvillalobosxl