pkgconf无法找到搜索路径中已存在的my.pc文件求助

问题详情 #

我在/usr/lib/pkgconfig目录下存放了如下my.pc文件：

prefix=/usr
exec_prefix=/usr
libdir=${exec_prefix}/lib
includedir=${prefix}/include

Name: my
Desctiption: My awesome library
Version: 0.0.1

Libs: -L${libdir} -lmy
Cflags: -I${includedir}

执行pkg-config --variable pc_path pkg-config确认pkgconf的搜索路径包含该目录，结果为：

/usr/lib/pkgconfig:/usr/share/pkgconfig

但运行pkgconf --libs my时仍报错，错误信息如下：

Package my was not found in the pkg-config search path.
Perhaps you should add the directory containing `my.pc'
to the PKG_CONFIG_PATH environment variable
Package 'my', required by 'virtual:world', not found

排查与解决方法 #

• 修正.pc文件拼写错误
  你的my.pc里存在关键字段拼写错误：Desctiption应为Description（少了字母r）。pkgconf解析.pc文件时，这类必填字段的拼写错误会直接导致包无法被识别，这是最可能的原因。

• 检查文件读取权限
  确保my.pc的权限允许pkgconf读取，执行命令查看权限：

  ls -l /usr/lib/pkgconfig/my.pc
  

  正常权限应为-rw-r--r--（其他用户可读），如果权限不足，用以下命令修正：

  sudo chmod 644 /usr/lib/pkgconfig/my.pc
  

• 区分pkg-config与pkgconf的差异
  部分系统中pkg-config和pkgconf是独立工具，缓存或配置逻辑可能不同。先尝试用pkg-config --libs my测试，如果能正常输出链接参数，说明是pkgconf的缓存问题，执行以下命令清理缓存：

  pkgconf --clean-cache
  

• 直接指定文件路径验证
  跳过搜索路径，直接指定.pc文件路径运行，确认文件内容有效性：

  pkgconf --libs /usr/lib/pkgconfig/my.pc
  

  如果此命令能输出正确的-L/usr/lib -lmy，说明问题出在工具搜索时的包识别环节，回到第一步检查拼写和权限即可。

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