Ubuntu(WSL环境)下CFITSIO库编译成功后无法链接/引用：fitsio.h未找到问题求助

我来帮你梳理几个实用的排查和解决步骤，都是在WSL Ubuntu环境下使用CFITSIO时容易遇到的情况：

• 先定位CFITSIO的实际安装位置
  编译完成后，头文件fitsio.h和库文件可能不在系统默认搜索路径里。你可以用这个命令快速找到它们的位置：

  find / -name fitsio.h 2>/dev/null
  

  输出的路径比如/usr/local/include/fitsio.h或者/home/your-user/cfitsio/include/fitsio.h，记下来这个路径前缀（比如/usr/local/include）。

• 编译时指定头文件搜索路径
  当你编译自己的C程序时，需要用-I参数告诉编译器去哪里找fitsio.h。比如如果头文件在/usr/local/include，编译命令应该写成：

  gcc your_program.c -I/usr/local/include -o your_program
  

  如果是自定义安装路径（比如你编译CFITSIO时加了--prefix=~/my-cfitsio），就把-I后面改成对应的include路径：-I~/my-cfitsio/include。

• 链接时指定库文件和路径
  仅仅找到头文件还不够，链接阶段需要指定CFITSIO的库文件。用-L指定库所在的路径，-lcfitsio链接CFITSIO库。完整的编译+链接命令应该像这样：

  gcc your_program.c -I/usr/local/include -L/usr/local/lib -lcfitsio -o your_program
  

  同样，如果是自定义路径，把-L后面改成库所在的路径，比如-L~/my-cfitsio/lib。

• 解决运行时动态库找不到的问题
  如果编译成功了，但运行程序时提示找不到libcfitsio.so之类的错误，需要配置动态库搜索路径：

  • 临时生效：在终端执行

    export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
    

  • 永久生效：编辑~/.bashrc文件，添加上面的export命令，然后执行source ~/.bashrc；或者编辑/etc/ld.so.conf，加入库路径后执行sudo ldconfig。

• 检查CFITSIO编译时的配置
  如果你编译CFITSIO时使用了./configure --prefix=xxx自定义安装路径，那所有后续的-I、-L参数都要对应这个xxx路径，不能混用系统默认路径。

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