Ubuntu 软连接跨版本的可行方案
一、推荐做法 使用 update-alternatives 管理多版本
- 适用场景：需要在多个已安装版本之间快速切换，例如 gcc/g++、python、java、cuda 等。
- 核心机制：在 /usr/bin 放置不带版本号的可执行名（如 gcc），它指向 /etc/alternatives/gcc；再由 alternatives 指向具体版本（如 /usr/bin/gcc-11）。这样切换版本只需改 alternatives 的指向，安全且可回退。
- 常用命令：
- 注册版本并设置优先级（数值越大优先级越高）
- sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 90
- sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 80
- 交互式切换
- sudo update-alternatives --config gcc
- 查看与查询
- update-alternatives --display gcc
- update-alternatives --list gcc
- 优点：系统级统一管理、切换可追溯、避免直接 rm/ln 造成误改；适合长期维护与团队协作。
二、直接软连接切换版本
- 适用场景：单一、明确的版本切换，或目录级切换（如 /usr/local/cuda 指向 /usr/local/cuda-12.1 或 /usr/local/cuda-11.8）。
- 基本用法：
- 创建/切换软连接
- sudo ln -sfn /usr/local/cuda-12.1 /usr/local/cuda
- 验证
- readlink -f /usr/local/cuda
- nvcc --version 或 ls /usr/local/cuda/bin
- 环境变量建议：将 PATH、LD_LIBRARY_PATH 指向“通用名”（如 /usr/local/cuda），避免把路径写死到具体版本目录；切换软连接后无需改环境变量。
- 适用示例：多版本 CUDA 共存时，用软连接统一 /usr/local/cuda 入口，按需指向不同 cuda-x.y。
三、共享库 so 的软连接与兼容规则
- 命名与作用
- linker-name：libxxx.so（编译链接阶段使用，通常是个软连接）
- soname：libxxx.so.M（运行期加载依赖，通常也是软连接，M 为主版本）
- real-name：libxxx.so.M.m.p（实际文件，带完整版本号）
- 运行时报错如 “cannot open shared object file: No such file or directory”，常见原因是缺少对应的 soname 软连接或缓存未更新。
- 处理步骤
- 确认库的真实路径：locate libxxx.so
- 建立缺失的 soname 软连接（示例）
- ln -s libhiredis.so.1.2.1-dev libhiredis.so.1.2.1
- ln -s libhiredis.so.1.2.1 libhiredis.so
- 让动态链接器识别新库：sudo ldconfig
- 注意：不要随意改动已安装库的 soname；应以库自身的 SONAME 为准创建链接，避免破坏兼容性。
四、跨版本切换的注意事项与排错
- 使用 alternatives 时，可用优先级实现“自动模式”（高优先级优先），也可“手动模式”固定版本；切换后运行对应命令验证版本号。
- 直接替换 /usr/bin 下的可执行文件或系统目录软连接前，先备份；对 /usr/local 等目录操作相对更安全。
- 共享库问题优先用 ldconfig 刷新缓存；若仍找不到，检查库目录是否纳入 /etc/ld.so.conf 或 /etc/ld.so.conf.d/ 并重新运行 ldconfig。
- 软连接有效性检查：ls -l、readlink -f；删除软连接用 rm（不要加斜杠），避免误删目标文件。