使用特定链接脚本编译C++源码时如何链接C++库及编译报错修复

你遇到的函数未声明错误是编译阶段头文件引入规则和编译参数误用导致的，问题点及修复步骤如下：

• 首先你的编译命令存在三处明显错误：
  1. -c参数代表仅执行编译阶段、不触发链接，此时传递-lstdc++、-llib/kernel.hpp这类链接阶段参数完全无效，且-l参数后仅能接库名，不能传入头文件
  2. 未添加头文件搜索路径，编译器无法找到lib目录下的kernel.hpp，导致头文件中声明的函数无法被识别
  3. 不能直接将.hpp头文件作为编译参数传递给gcc
• 修复编译报错的操作：
  1. 先修改main.cpp的编译命令，添加-I参数指定头文件搜索路径：

     gcc -m32 -c main.cpp -o main.o -I./lib
     

  2. 确认main.cpp中已正确添加#include "kernel.hpp"引入头文件，同时排查头文件中函数是否存在命名空间不匹配、声明与实现不一致、被错误添加static限定符的问题。

完整流程分为编译目标文件、打包可选静态/动态库、指定链接脚本链接三个阶段：

1. 编译所有源文件为目标文件 #

• 编译lib目录下的库源码：

  gcc -m32 -c lib/kernel.cpp -o lib/kernel.o -I./lib
  # 如果要编译动态库，需要额外添加-fPIC参数：
  # gcc -m32 -fPIC -c lib/kernel.cpp -o lib/kernel.o -I./lib
  

2. 可选：打包为静态/动态库 #

• 打包静态库：

  ar rcs lib/libkernel.a lib/kernel.o
  

• 打包动态库：

  gcc -m32 -shared -o lib/libkernel.so lib/kernel.o
  

3. 指定链接脚本执行链接 #

假设你的自定义链接脚本名为custom.lds，使用-T参数指定链接脚本：

• 直接链接目标文件的命令：

  gcc -m32 -T custom.lds main.o lib/kernel.o -o main -lstdc++
  

• 链接静态库的命令：

  gcc -m32 -T custom.lds main.o -o main -L./lib -lkernel -lstdc++
  

  其中-L指定库文件搜索路径，-lkernel对应链接名为libkernel.a的静态库。
• 链接动态库的命令和静态库一致，运行程序前需要将动态库所在目录添加到环境变量：

  export LD_LIBRARY_PATH=./lib:$LD_LIBRARY_PATH
  ./main
  

注意事项 #

• 32位编译需要提前安装对应32位依赖，例如Debian/Ubuntu系统需要安装lib32stdc++-dev，否则会出现找不到-lstdc++的错误
• 链接脚本路径需要填写正确，如果不在当前工作目录需要写绝对路径
• 如果你使用g++代替gcc编译C代码，可以不用手动添加-lstdc++参数，编译器会自动链接C标准库

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