CFITSIO_SONAME值不匹配导致已编译二进制文件无法执行问题求助

根因说明 #

这是头文件搜索路径优先级冲突导致的版本不匹配问题，哪怕使用双引号引用头文件，也可能因为编译选项的搜索顺序配置问题优先命中全局路径的头文件。

遗漏配置排查&解决步骤 #

• 检查编译命令的头文件搜索路径顺序
  确保项目本地Include文件夹的搜索选项-I./Include（替换为你实际的相对/绝对路径）出现在所有全局搜索路径（比如-I/usr/include、-I/usr/local/include）的前面。编译器的头文件搜索是严格按照命令行中-I参数的先后顺序依次查找的，顺序错误会直接导致先命中全局路径的fitsio.h。
• 验证实际使用的头文件路径
  编译时添加-H参数（gcc/clang通用），编译输出会打印所有被引用头文件的完整路径，可直接确认fitsio.h的实际加载目录：

  gcc -H 你的其他编译参数 源文件.c -o 输出文件
  

• 覆盖隐式全局搜索路径
  部分编译环境会默认将/usr/include等路径加入头文件搜索列表，且优先级高于双引号对应的当前目录，此时可以通过编译参数强制指定本地头文件优先：

  gcc -I./Include -idirafter /usr/include 其他编译参数
  

  该参数会将/usr/include的搜索优先级放到你主动指定的-I路径之后。
• 同步检查链接阶段的库文件匹配
  解决头文件问题后，还要确保链接时优先链接与本地头文件配套的CFITSIO库文件，而非全局的libcfitsio.so，添加库搜索路径时同样要把本地库存放的路径放在最前面：

  gcc -L./你的本地库目录 -lcfitsio 其他链接参数
  

  如果运行时仍然优先加载全局库，可以添加-Wl,-rpath=./你的本地库目录参数，将本地库路径写入二进制文件的运行时搜索路径。
• 极端情况兜底方案
  直接写死头文件的相对路径引用，完全避开搜索路径干扰：

  #include "./Include/fitsio.h"
  

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