Rustup 1.30 的 XDG 路径支持怎么试：目录迁移、兼容性与回退检查

Rustup 团队在 1.30 开发周期里把 XDG 路径支持列为后续工作，这意味着它目前更适合当作环境迁移的观察项，而不是可以直接依赖的稳定开关。真正要做试验，先记录现有工具链目录、项目是否写死路径，再用隔离目录验证构建结果；不要直接移动线上或团队共享机器上的 Rust 工具链。

Rustup 1.30 的变化现在能确认到哪一步

官方 Rustup 团队在 2026 年 7 月的开发周期说明中，把 XDG Paths Support 放在“近期准备处理”的事项里。文章同时提到 1.30 周期还涉及隐式安装行为、下载后端和 TLS 后端等方向，但没有给出一个已经稳定发布、可以用开关启用的 XDG 迁移命令。

这个时间点很容易被误读：可以关注、可以在隔离环境观察变更，但不能据此断言 ~/.rustup 或 ~/.cargo 已经会自动遵循 XDG Base Directory 规范。工程上先把“官方计划”和“本机现状”分开，后续升级才不会把目录变化误判成编译器故障。

先做一份不会破坏环境的基线记录

在任何试验前，把下面几项输出保存到项目的升级记录中。命令只读，不会移动工具链；如果机器上没有某个变量，空值本身也是有用信息。

rustup --version
rustc --version --verbose
cargo --version
rustup show active-toolchain
printf 'RUSTUP_HOME=%s\n' "${RUSTUP_HOME:-}"
printf 'CARGO_HOME=%s\n' "${CARGO_HOME:-}"
printf 'PATH=%s\n' "$PATH"
rustup toolchain list

重点看三件事：当前命令来自哪个目录，活动工具链是否已经安装，项目脚本有没有把某个绝对路径写进 Makefile、容器镜像或 CI 配置。先记住这些路径，后面的任何变化才有对照。

用隔离目录验证路径变化，而不是直接搬家

Rustup 现有版本通常通过 RUSTUP_HOME 和 CARGO_HOME 控制数据目录。它们可以用于验证“另一套空环境能否独立安装和构建”，但这不等于 XDG 迁移已经由 Rustup 正式实现。

可以在临时用户目录或一次性 shell 中做隔离试验：

tmp_root="$(mktemp -d)"
export RUSTUP_HOME="$tmp_root/rustup"
export CARGO_HOME="$tmp_root/cargo"
rustup toolchain install stable --profile minimal
rustup default stable
rustc --version
cargo new xdg-path-check
cd xdg-path-check
cargo check

这里的验收重点不是“命令能跑”这么简单。检查 rustup show 是否指向新环境，确认 cargo check 没有悄悄使用旧目录，并记录目标平台是否和原环境一致。试验完成后关闭该 shell，旧环境仍应保持可用。

迁移时最容易漏掉的三条依赖链

尤其要留意 CI。很多流水线并不是调用 PATH 里的 cargo，而是通过预装镜像、缓存目录或自定义 action 固定工具链位置。新目录试验通过后，还要在干净 runner 上跑一次最小构建，才能知道迁移是否真的可复现。

出现异常时按症状回退

如果试验环境出现“toolchain not installed”、组件下载失败或依赖缓存找不到，先不要删除旧目录。关闭隔离 shell，恢复原来的 RUSTUP_HOME、CARGO_HOME，再重新运行基线命令。这样能区分是目录变量的问题，还是工具链本身的问题。

unset RUSTUP_HOME
unset CARGO_HOME
rustup show active-toolchain
rustc --version
cargo check

若团队脚本里已经写入了新变量，建议先通过一个明确的开关控制，而不是覆盖所有开发者的 shell 配置。回退路径要能在一条提交或一次环境变量恢复中完成，这比迁移成功后再猜旧目录在哪里可靠得多。

把“值得跟进”变成可执行的升级清单

• 关注 Rustup 官方 1.30 发布说明，确认 XDG 支持从计划变成了什么具体行为。
• 在 Linux、macOS 和 CI runner 各保存一份路径基线，不要只在个人电脑试验。
• 用最小项目验证默认工具链、交叉编译 target、依赖缓存和离线构建四个结果。
• 保留旧目录和回退变量；没有明确迁移说明前，不把新目录结构写死进安装脚本。

延伸问答

现在可以直接把 Rustup 目录移动到 XDG 目录吗？

不建议把手工移动目录当作官方迁移。可以用环境变量启动一套隔离环境做验证，但必须保留原目录，并确认项目和 CI 没有引用旧路径。

只运行 rustc --version 能证明迁移成功吗？

不能。它只能说明当前命令能启动，还需要核对活动工具链、组件、target、cargo 缓存和最小项目构建。

为什么同一台机器本地成功，CI 仍然失败？

CI 可能使用不同的镜像、缓存 key 或环境变量。把基线命令和最小构建放进干净 runner，才能识别这些环境差异。

总结

Rustup 1.30 的 XDG 路径支持目前应当按官方计划跟踪，按隔离实验验证，不按稳定功能直接迁移。先记录现状，再验证新环境，最后在多平台和 CI 上复查，出现异常时保留旧目录回退，升级成本就能控制在可观察、可恢复的范围内。