如何仅用.h文件编译程序并实现库的运行时链接而非编译时链接？

一、无.so文件时用.h文件编译程序的解决方法 #

g++报“找不到函数xxx定义”，核心原因是.h文件只包含函数声明，没有具体实现（除非是inline函数、模板这类特殊情况）。要编译通过，得把函数的实现代码纳入编译流程，具体分几种情况：

• 如果函数实现写在.cpp文件里：
  编译时必须把对应的.cpp文件一起传给g++，比如主文件是main.cpp，函数xxx的实现在func.cpp，命令如下：

  g++ main.cpp func.cpp -o my_program
  

  只要main.cpp里已经通过#include "func.h"引入了函数声明，编译时把实现文件一起编译链接，就能找到函数定义。

• 把函数实现直接写在.h文件里：
  给函数加上inline关键字，示例：

  // func.h
  inline int xxx() {
      // 函数实现代码
      return 0;
  }
  

  inline函数会被编译器直接内联到调用位置，不需要单独的.cpp文件。但要注意：所有包含这个.h的编译单元里，inline函数的代码必须完全一致，否则会触发未定义行为。另外，模板函数本身就必须在头文件里实现，因为编译器需要在实例化时看到完整代码。

• 如果有静态库(.a文件)：
  静态库是编译好的目标文件打包产物，编译时用-l指定库名，-L指定库路径，命令示例：

  g++ main.cpp -o my_program -L./lib_dir -lxxx
  

  静态库会被直接打包进可执行文件，运行时不需要依赖.so文件。

二、让程序在运行时而非编译时链接库（动态加载） #

这种方式叫动态加载，不需要在编译时链接.so，而是在程序运行时手动加载库、获取函数指针并调用。Linux下用POSIX标准的dlopen系列API，步骤如下：

1. 编译时链接dl库：
   因为要用到dlopen等函数，编译时需要加-ldl参数：

   g++ main.cpp -o my_program -ldl
   

2. 代码里实现动态加载逻辑：
   示例代码：

   #include <dlfcn.h>
   #include <iostream>
   
   int main() {
       // 打开动态库，RTLD_LAZY表示延迟解析符号
       void* lib_handle = dlopen("./libxxx.so", RTLD_LAZY);
       if (!lib_handle) {
           std::cerr << "加载库失败: " << dlerror() << std::endl;
           return 1;
       }
   
       // 获取函数指针，先定义函数类型
       typedef int (*xxx_func_t)(); // 假设xxx是无参返回int的函数
       xxx_func_t xxx = (xxx_func_t)dlsym(lib_handle, "xxx");
       const char* err = dlerror();
       if (err) {
           std::cerr << "获取函数失败: " << err << std::endl;
           dlclose(lib_handle);
           return 1;
       }
   
       // 调用函数
       int result = xxx();
       std::cout << "调用xxx结果: " << result << std::endl;
   
       // 关闭库句柄
       dlclose(lib_handle);
       return 0;
   }
   

   注意：如果库中的函数是C++编译的，需要用extern "C"声明函数，否则函数名会被编译器篡改（name mangling），导致dlsym找不到。比如在库的代码里：

   extern "C" int xxx() {
       // 函数实现
   }
   

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