ldconfig未识别/opt/lib下的libgit2.so，pygit安装失败如何解决？

Let's walk through the steps to get ldconfig recognizing your libgit2 library in /opt/lib and resolve that annoying "cannot find -lgit2" error.

1. Verify libgit2 is actually installed in /opt/lib #

First, let's confirm the library files exist where you expect them. Run this command to list all libgit2-related files in /opt/lib:

ls -l /opt/lib/libgit2*

You should see something like libgit2.so.1.7.0 (the exact version number might vary) and ideally a symlink libgit2.so pointing to that file. If the symlink is missing, we'll fix that later. If you don't see any libgit2 files at all, your libgit2 installation probably didn't target /opt correctly—double-check that you used --prefix=/opt (for autotools) or -DCMAKE_INSTALL_PREFIX=/opt (for CMake) when compiling libgit2.

2. Confirm /opt/lib is in the dynamic linker configuration #

Next, ensure your custom path is properly registered with the system linker:

• Check the main ld.so.conf file:

  cat /etc/ld.so.conf
  

  Look for a line that says /opt/lib. If it's not there, add it (you'll need sudo):

  sudo echo "/opt/lib" >> /etc/ld.so.conf
  

• Alternatively, many systems prefer adding a dedicated .conf file in /etc/ld.so.conf.d/ (this is cleaner). Create a file like opt-lib.conf:

  sudo echo "/opt/lib" > /etc/ld.so.conf.d/opt-lib.conf
  

3. Update the linker cache with ldconfig #

Now, force the linker to refresh its cache. This step is crucial—don't skip it, and make sure to run it as root:

sudo ldconfig

To verify that libgit2 is now in the cache, run:

ldconfig -p | grep libgit2

You should see your libgit2 library listed here. If not, move to the next step.

4. Manually create the missing symlink (if needed) #

Sometimes when compiling libraries, the libgit2.so symlink (which the linker looks for when using -lgit2) isn't created automatically. If you saw libgit2.so.x.y.z but no libgit2.so in step 1, create the symlink manually:

sudo ln -s /opt/lib/libgit2.so.x.y.z /opt/lib/libgit2.so

Replace x.y.z with the actual version number from your ls output. Then re-run sudo ldconfig to update the cache.

5. Ensure pygit2 looks in the right place during installation #

Even if the system linker knows about /opt/lib, the compiler might not pick it up when installing pygit2. Try setting the necessary flags before running your install command:

CFLAGS="-I/opt/include" LDFLAGS="-L/opt/lib" pip install pygit2

This tells the compiler to look for headers in /opt/include (where libgit2's headers should be) and libraries in /opt/lib.

If you're using a setup.py instead of pip, set these environment variables first:

export CFLAGS="-I/opt/include"
export LDFLAGS="-L/opt/lib"
python setup.py install

6. Test the library is accessible #

After fixing the symlinks and updating the cache, test if the system can find libgit2:

ldd /opt/lib/libgit2.so.x.y.z

This should show all dependencies are resolved. If ldconfig -p shows it, and the install flags are set, pygit2 should now install without issues.

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