使用musl-gcc编译synctex时提示zlib.h不存在的问题求助

问题描述 #

尝试用musl-gcc编译synctex项目，执行编译命令：

root@f94968c590bb:/home/rust/src/synctex# musl-gcc -c -fPIC *.c
synctex_parser.c:501:25: fatal error: zlib.h: No such file or directory
  501 | #               include <zlib.h>
      |                         ^~~~~~~~
compilation terminated.

编译失败提示找不到zlib.h，但已确认系统中zlib1g-dev（即libz-dev）已安装到最新版本：

root@f94968c590bb:/home/rust/src/synctex# apt-get install zlib1g-dev
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
zlib1g-dev is already the newest version (1:1.2.11.dfsg-2ubuntu9.2).
0 upgraded, 0 newly installed, 0 to remove and 19 not upgraded.
root@f94968c590bb:/home/rust/src/synctex# apt-get install libz-dev
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'zlib1g-dev' instead of 'libz-dev'
zlib1g-dev is already the newest version (1:1.2.11.dfsg-2ubuntu9.2).
0 upgraded, 0 newly installed, 0 to remove and 19 not upgraded.

当前使用的musl-gcc版本信息：

root@f94968c590bb:/home/rust/src/synctex# musl-gcc -v
Using built-in specs.
Reading specs from /usr/lib/x86_64-linux-musl/musl-gcc.specs
rename spec cpp_options to old_cpp_options
COLLECT_GCC=x86_64-linux-gnu-gcc
COLLECT_LTO_WRAPPER=/usr/lib/gcc/x86_64-linux-gnu/11/lto-wrapper
OFFLOAD_TARGET_NAMES=nvptx-none:amdgcn-amdhsa
OFFLOAD_TARGET_DEFAULT=1
Target: x86_64-linux-gnu
Configured with: ../src/configure -v --with-pkgversion='Ubuntu 11.4.0-1ubuntu1~22.04' --with-bugurl=file:///usr/share/doc/gcc-11/README.Bugs --enable-languages=c,ada,c++,go,brig,d,fortran,objc,obj-c++,m2 --prefix=/usr --with-gcc-major-version-only --program-suffix=-11 --program-prefix=x86_64-linux-gnu- --enable-shared --enable-linker-build-id --libexecdir=/usr/lib --without-included-gettext --enable-threads=posix --libdir=/usr/lib --enable-nls --enable-bootstrap --enable-clocale=gnu --enable-libstdcxx-debug --enable-libstdcxx-time=yes --with-default-libstdcxx-abi=new --enable-gnu-unique-object --disable-vtable-verify --enable-plugin --enable-default-pie --with-system-zlib --enable-libphobos-checking=release --with-target-system-zlib=auto --enable-objc-gc=auto --enable-multiarch --disable-werror --enable-cet --with-arch-32=i686 --with-abi=m64 --with-multilib-list=m32,m64,mx32 --enable-multilib --with-tune=generic --enable-offload-targets=nvptx-none=/build/gcc-11-XeT9lY/gcc-11-11.4.0/debian/tmp-nvptx/usr,amdgcn-amdhsa=/build/gcc-11-XeT9lY/gcc-11-11.4.0/debian/tmp-gcn/usr --without-cuda-driver --enable-checking=release --build=x86_64-linux-gnu --host=x86_64-linux-gnu --target=x86_64-linux-gnu --with-build-config=bootstrap-lto-lean --enable-link-serialization=2
Thread model: posix
Supported LTO compression algorithms: zlib zstd
gcc version 11.4.0 (Ubuntu 11.4.0-1ubuntu1~22.04)

解答 #

1. 能否用musl-gcc编译synctex？ #

可以。synctex的核心代码没有依赖glibc专属特性，只要正确配置依赖路径，就能用musl-gcc完成编译。

2. 解决zlib.h缺失的方法 #

错误原因是musl-gcc默认的头文件搜索路径不包含系统安装的zlib头文件目录，可通过以下方式解决：

方式一：编译时显式指定路径

编译命令中添加-I指定zlib头文件目录，-L指定库目录，-lz链接zlib库：

musl-gcc -c -fPIC *.c -I/usr/include -L/usr/lib/x86_64-linux-gnu -lz

如果不确定头文件位置，可执行find /usr -name zlib.h查找，通常默认在/usr/include下。

方式二：修改musl-gcc的specs配置文件

编辑/usr/lib/x86_64-linux-musl/musl-gcc.specs，找到*cpp_options:部分，添加系统头文件路径，修改后示例：

*cpp_options:
-I/usr/include -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64

修改后后续编译无需手动指定路径。

方式三：编译musl专属的zlib版本

若担心系统zlib（针对glibc编译）存在兼容性问题，可手动编译musl版本的zlib：

1. 下载zlib源码：wget https://zlib.net/zlib-1.2.13.tar.gz
2. 解压并编译安装：

tar xzf zlib-1.2.13.tar.gz
cd zlib-1.2.13
CC=musl-gcc ./configure --prefix=/usr/local/musl
make && make install

3. 编译synctex时指定该路径：

musl-gcc -c -fPIC *.c -I/usr/local/musl/include -L/usr/local/musl/lib -lz

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