14、链接目录管理：link_directories与target_link_directories的区别
链接目录管理，说白了就是告诉链接器：「喂，你的库文件放在哪个文件夹里？」。这个问题看似简单，但我在实际项目中见过不少人在这里栽跟头。今天我们就来聊聊 link_directories 和 target_link_directories 这对「兄弟」到底有什么区别。
先说说背景
CMake 里管理链接库，通常有两种方式：一种是直接给全路径（比如 /usr/local/lib/libfoo.a），另一种是给库名（比如 foo），让链接器自己去搜索。第二种方式就需要告诉链接器去哪里搜。这时候，link_directories 和 target_link_directories 就派上用场了。
嗯，这里要注意：它们俩的作用范围完全不同。我刚开始用 CMake 时，总觉得随便用一个就行，结果在大型项目里踩了坑。
link_directories：全局的「懒人模式」
link_directories 是一个目录级别的命令。你把它写在 CMakeLists.txt 的某个位置，它就会影响在这个命令之后定义的所有目标。说白了，它是一个全局设置。
# 示例：link_directories 的用法
link_directories(/usr/local/custom_libs /opt/third_party/lib)
add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE foo bar)
上面的代码中，my_app 链接 foo 和 bar 时，链接器会去 /usr/local/custom_libs 和 /opt/third_party/lib 里找。看起来挺方便对吧？
但问题来了：这个设置是全局的。如果你在同一个 CMakeLists.txt 里定义了多个目标，它们都会受到影响。我在项目中遇到过这样的情况：一个库的链接目录被全局设置污染了，导致链接了错误的版本，调试了一整天。
link_directories，导致子目录中的目标也意外链接到了错误的库版本。全局设置就像「广播」，你无法精确控制谁收到谁收不到。
target_link_directories：精准的「狙击模式」
target_link_directories 是 CMake 3.13 引入的命令。它只影响指定的目标，不会污染其他目标。你想想看，这才是现代 CMake 提倡的「目标导向」风格。
# 示例：target_link_directories 的用法
add_executable(my_app main.cpp)
target_link_directories(my_app PRIVATE /usr/local/custom_libs /opt/third_party/lib)
target_link_libraries(my_app PRIVATE foo bar)
add_executable(my_other_app other.cpp)
# my_other_app 不会受到上面设置的影响
这里 PRIVATE 关键字表示这个目录设置只对 my_app 本身有效。如果你想让链接目录也传递给依赖 my_app 的其他目标，可以用 PUBLIC 或 INTERFACE。我个人习惯用 PRIVATE，除非明确需要传递。
核心区别对比
| 特性 | link_directories | target_link_directories |
|---|---|---|
| 作用范围 | 全局（影响之后所有目标） | 仅影响指定目标 |
| 引入版本 | CMake 早期版本 | CMake 3.13+ |
| 可传递性 | 不支持（全局无法控制传递） | 支持 PRIVATE/PUBLIC/INTERFACE |
| 推荐程度 | 不推荐（除非维护旧项目） | 强烈推荐 |
| 调试难度 | 高（全局污染难排查） | 低（作用域清晰） |
为什么我推荐用 target_link_directories？
说白了，现代 CMake 的核心思想就是「目标就是一切」。每个目标（可执行文件、库）都应该明确声明自己的依赖和属性，而不是依赖全局状态。target_link_directories 完美契合这个理念。
我记得有一次，团队里新来的同事用 link_directories 添加了一个目录，结果导致另一个模块链接了错误的 OpenCV 版本。排查了半天才发现是全局设置惹的祸。从那以后，我们团队就规定：新代码一律使用 target_link_directories。
link_directories，建议把它放在 CMakeLists.txt 的最前面，并且用注释标明。这样至少能让后来人知道：「这里有个全局设置，小心别被坑」。
实战中的选择建议
- 新项目：直接用
target_link_directories，配合target_link_libraries使用。干净利落。 - 旧项目迁移：逐步将
link_directories替换为target_link_directories。可以先从最内层的子目录开始改。 - 第三方库路径：如果所有目标都需要同一个目录，用
link_directories也不是不行。但我会建议用find_library或find_package来管理，更规范。
知识体系图
下面这张图帮你理清这两个命令在 CMake 链接流程中的位置：
总结
link_directories 和 target_link_directories 的区别，本质上就是「全局 vs 局部」的较量。现代 CMake 已经明确告诉我们：局部优于全局，显式优于隐式。所以，别再偷懒用全局设置了，给你的每个目标都配上专属的链接目录吧。
嗯，最后提醒一句：如果你还在用 CMake 3.12 及以下版本，那 target_link_directories 就用不了。这时候可以考虑升级 CMake，或者用 find_library 来曲线救国。我个人建议升级，毕竟新版本修复了不少 bug，性能也更好。