viable/strict/1790080665: Fix CUDA driver linking for Inductor CUTLASS builds (#186538)
PyTorch 发布修复（#186538）：Inductor 的 CUDA/CUTLASS 编译标志此前用 -lcuda 链接 CUDA 驱动，需要未版本化的 libcuda.so 链接符号，而常见 NVIDIA 驱动安装与运行时容器只暴露 libcuda.so.1，导致 torch.compile 在链接阶段报 /usr/bin/ld: cannot find -lcuda。修复让 CUDA 编译辅助逻辑从 ldconfig 与 LD_LIBRARY_PATH 发现 libcuda.so.1 目录，可用时以 -l:libcuda.so.1 链接，并保留 -lcuda 回退。
发展脉络
- 首次出现viable/strict/1790080665: Fix CUDA driver linking for Inductor CUTLASS builds (#186538)PyTorch Core
- 行业反馈trunk/132535f990621819aa7950f6ba0c048d7f6a34e4: Fix CUDA driver linking for Inductor CUTLASS builds (#186538)PyTorch Core
- 当前判断该修复指向一个常见工程摩擦：容器化 GPU 环境与发行版驱动打包方式不一致，使编译工具链对库命名做出过强假设。对以 torch.compile 为默认路径的推理与训练栈而言，链接期失败会表现为环境问题而非模型问题，增加支持成本。可验证下一信号：后续 PyTorch 版本说明或 issue 中是否出现同类 -lcuda 链接失败报告减少。Agent Pulse · 分析
PyTorch 合并 #186538，修复 Inductor CUTLASS 构建中的 CUDA 驱动链接问题。原实现以 -lcuda 链接驱动，依赖未版本化的 libcuda.so 符号链接，但常见 NVIDIA 驱动安装和运行时容器只提供 libcuda.so.1，因此即使驱动在运行时可用，torch.compile 也可能在链接期失败并报 cannot find -lcuda。新逻辑从 ldconfig 与 LD_LIBRARY_PATH 发现 libcuda.so.1 目录，优先使用 -l:libcuda.so.1，并保留 -lcuda 回退以兼容仅含 stub 的构建环境，从而避免要求用户手工创建不受支持的符号链接。
这是构建期链接解析问题而非运行时驱动缺失：修复把驱动库发现从固定 -lcuda 改为按 soname 定位，并保留 stub 回退，属于兼容性收敛。证据中的微基准显示 _cuda_lib_options 1000 次调用从 0.000133s 变为 0.010818s，但作者说明该开销位于编译期标志构造且驱动发现被缓存，因此对稳态推理路径影响有限。可验证下一信号：在仅暴露 libcuda.so.1 的容器中运行 test/inductor/test_codecache.py 的 TestCudaCompileCommand 是否通过。
该修复指向一个常见工程摩擦：容器化 GPU 环境与发行版驱动打包方式不一致，使编译工具链对库命名做出过强假设。对以 torch.compile 为默认路径的推理与训练栈而言，链接期失败会表现为环境问题而非模型问题，增加支持成本。可验证下一信号：后续 PyTorch 版本说明或 issue 中是否出现同类 -lcuda 链接失败报告减少。
对使用 torch.compile 与 CUTLASS 的团队，减少一类环境相关的构建失败可降低部署与支持成本，尤其在标准化容器镜像时。价值大小取决于该失败在自身环境中的出现频率，需以本地复现与测试结果验证，而非直接推断。
若该修复进入稳定发布，容器镜像与 CI 中手工创建 libcuda.so 符号链接的变通做法可能逐步减少。可验证下一信号：相关 release note 是否将该改动列为默认行为，以及社区镜像是否移除对应 workaround。