如何迁移RUST工具安装目录？rustup操作与环境变量疑问

一、迁移已安装的Rust到AppData目录 #

rustup没有提供一键迁移工具，无需完全卸载重装，可通过手动步骤完成迁移：

具体步骤： #

1. 关闭相关程序：确保所有使用Rust工具的终端、编辑器（如VS Code）、IDE都已关闭。
2. 备份数据：复制当前的.cargo和.rustup目录到安全位置，避免迁移失败丢失数据。
3. 移动目录：将原目录
   • C:\Users\*JOE_USER*\OneDrive\Documents\Src\.cargo
   • C:\Users\*JOE_USER*\OneDrive\Documents\Src\.rustup
     移动到目标路径，比如：
   • %LOCALAPPDATA%\Rust\.cargo
   • %LOCALAPPDATA%\Rust\.rustup
4. 更新环境变量：
   • 打开系统环境变量设置（Win+R输入sysdm.cpl → 高级 → 环境变量）
   • 修改RUSTUP_HOME的值为%LOCALAPPDATA%\Rust\.rustup
   • 修改CARGO_HOME的值为%LOCALAPPDATA%\Rust\.cargo
   • 确认PATH中包含%CARGO_HOME%\bin（如果没有则添加）
5. 验证迁移：打开新的终端窗口，执行以下命令确认正常工作：

   rustup --version
   cargo --version
   rustc --version
   

二、关于RUSTUP_HOME和CARGO_HOME的理解验证 #

你的理解完全正确：

• 在安装rustup前设置RUSTUP_HOME，rustup会将工具链（如stable-x86_64-pc-windows-msvc）安装到该目录下；
• 设置CARGO_HOME后，cargo的可执行文件（如cargo.exe、rustc.exe）会放在%CARGO_HOME%\bin目录，同时cargo的配置文件、下载的依赖包也会存储在该目录下；
• 安装过程中rustup会自动将%CARGO_HOME%\bin添加到系统PATH，方便直接在终端调用Rust工具。

补充信息（来自你的环境）： #

当前版本信息：

C:\>rustup --version
rustup 1.26.0 (5af9b9484 2023-04-05)
info: This is the version for the rustup toolchain manager, not the rustc compiler.
info: The currently active `rustc` version is `rustc 1.73.0 (cc66ad468 2023-10-03)`

当前环境变量：

C:\Users\*JOE_USER*>echo "%CARGO_HOME%" && echo "%RUSTUP_HOME%"
"C:\Users\*JOE_USER*\OneDrive\Documents\Src\.cargo"
"C:\Users\*JOE_USER*\OneDrive\Documents\Src\.rustup"

.cargo\bin目录内容：

Directory of C:\Users\*JOE_USER*\OneDrive\Documents\Src\.cargo\bin

08/11/2023  09:38 PM    <DIR>          .
03/01/2023  10:06 AM    <DIR>          ..
08/11/2023  08:57 PM         8,594,944 cargo-clippy.exe
08/11/2023  08:57 PM         8,594,944 cargo-fmt.exe
08/11/2023  08:57 PM         8,594,944 cargo-miri.exe
08/11/2023  08:57 PM         8,594,944 cargo.exe
08/11/2023  08:57 PM         8,594,944 clippy-driver.exe
08/11/2023  08:57 PM         8,594,944 rls.exe
08/11/2023  08:57 PM         8,594,944 rust-analyzer.exe
08/11/2023  08:57 PM         8,594,944 rust-gdb.exe
08/11/2023  08:57 PM         8,594,944 rust-gdbgui.exe
08/11/2023  08:57 PM         8,594,944 rust-lldb.exe
08/11/2023  08:57 PM         8,594,944 rustc.exe
08/11/2023  08:57 PM         8,594,944 rustdoc.exe
08/11/2023  08:57 PM         8,594,944 rustfmt.exe
08/11/2023  08:57 PM         8,594,944 rustup.exe

工具链实际可执行文件目录：

Directory of C:\Users\*JOE_USER*\OneDrive\Documents\Src\.rustup\toolchains\stable-x86_64-pc-windows-msvc\bin

10/16/2023  02:51 PM        22,269,440 cargo.exe
10/16/2023  02:51 PM         9,035,776 clippy-driver.exe
10/16/2023  02:51 PM           770,048 cargo-clippy.exe
10/16/2023  02:52 PM         4,706,304 test-bdd24cd8003a6271.pdb
10/16/2023  02:52 PM         6,868,992 std-287abad1c0bdb9b8.pdb
10/16/2023  02:52 PM        60,534,784 rustc_driver-ecc82c9d925511c8.pdb
10/16/2023  02:52 PM               265 rust-windbg.cmd
10/16/2023  02:52 PM         3,575,808 rustc_main-0b34c7ab06f9785c.pdb
10/16/2023  02:52 PM           112,128 rustc.exe
10/16/2023  02:52 PM         8,693,248 rustdoc.exe
10/16/2023  02:52 PM         1,699,328 test-bdd24cd8003a6271.dll
10/16/2023  02:52 PM        11,128,320 std-287abad1c0bdb9b8.dll
10/16/2023  02:52 PM       133,861,888 rustc_driver-ecc82c9d925511c8.dll
10/16/2023  02:52 PM    <DIR>          ..
10/16/2023  02:52 PM         1,354,240 cargo-fmt.exe
10/16/2023  02:52 PM         5,092,352 rustfmt.exe
10/16/2023  02:52 PM    <DIR>          .

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