【笔记】旧版MSYS2 环境中 Rust 升级问题及解决过程

下面是一份针对在旧版 MSYS2(安装在 D 盘)中,基于 Python 3.11 的 Poetry 虚拟环境下升级 Rust 的处理过程笔记(适用于 WIN 系统 SUNA 人工智能代理开源项目部署要求)的记录。


MSYS2 旧版环境中 Rust 升级问题及解决过程

背景

msys2-x86_64-20231026.exe #2023年10月26日发布的版本(仅支持python3.11)

  • MSYS2 版本较旧 ,且安装在 D:\msys64 下。
  • 由于部署要求,使用的是 Python 3.11 的 Poetry 虚拟环境(无法降级 Python 版本,只能升级)。
  • MSYS2 默认提供的 Rust 版本较旧(通过 pacman 安装的 Rust 为 1.73.0),而部分依赖(如 maturin、clap_derive、tokenizers等)要求至少 Rust 1.74 以上。
  • 解决方案是借助官方 Rustup 工具安装最新 Rust 工具链。

问题描述

  1. Rust 版本滞后

    • 通过 MSYS2 自带的 pacman 安装的 Rust 版本为 1.73.0,不满足依赖构建要求,导致编译错误。
  2. Rustup 安装位置与路径问题

    • 官方 Rustup 安装在 C:\Users\love\.cargo\bin 下,而 MSYS2 安装在 D 盘,导致默认 PATH 设置及工具调用出现混淆。
    • 初期 MSYS2 环境中未能正确找到 Rustup 命令,仍显示系统使用旧版编译器。

解决过程

rustup.rs - Rust 工具链安装程序

1. 安装 Rustup

由于 MSYS2 自带的仓库中没有提供 Rustup 包,我们通过官方提供的安装程序进行安装。

  • 步骤

    1. 使用浏览器访问 rustup.rs - The Rust toolchain installer 并下载 rustup-init.exe
    2. 在 Windows 系统环境下(或在 MSYS2 终端中转到下载目录)运行 rustup-init.exe
    3. 在提示中选择 标准安装 (直接回车),并在遇到"已有 Rust 安装"的警告时选择继续安装(输入 y)。

    cd "E:\Downloads\Programs"
    ./rustup-init.exe

  • 提示

    尽管 MSYS2 中已通过 pacman 安装了旧版 Rust(位于 D:\msys64\mingw64\bin),但建议使用 Rustup 所管理的新工具链作为主要 Rust 环境,以解决构建依赖问题。


2. 更新 MSYS2 中的 PATH 环境变量

由于 Rustup 安装在 C:\Users\love\.cargo\bin,而 MSYS2 默认并不包含此路径,需要手动调整。

  • 临时修改 PATH(在 MSYS2 终端中执行):

    复制代码
    export PATH="/c/Users/love/.cargo/bin:$PATH"

    执行后,可验证:

    复制代码
    rustup --version

    如果能正确显示 Rustup 版本,则表明 PATH 调整成功。

  • 永久设置

    将上述 PATH 添加至 ~/.bashrc 中,使每次打开 MSYS2 终端时都自动生效:

    复制代码
    echo 'export PATH="/c/Users/love/.cargo/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc

3. 更新 Rust 工具链(可选)

确保在 MSYS2 中使用最新的 Rust 版本:

  • 通过 Rustup 更新:

    复制代码
    rustup update stable
  • 如有必要,在项目目录中使用覆盖命令,让 MSYS2 默认调用 Rustup 版本:

    复制代码
    rustup override set stable
  • 验证版本:

    复制代码
    rustc --version
    cargo --version

    期望输出为 Rust 1.87.0(或其他新版稳定版)和相应版本的 Cargo。


注意事项

  • Python 3.11 环境保持不变

    因为部署要求中基于旧版 MSYS2 中的 Python 3.11 的 Poetry 虚拟环境,无法降级 Python 版本。所以本次只侧重于解决 Rust 升级问题,而 Python 环境则保持原状。

  • 路径冲突问题

    由于 MSYS2 安装在 D 盘,而 Rustup 默认安装在 C 盘,对于 Windows 子系统、CMD 或 PowerShell 调用时,需额外注意 PATH 的优先级设置,确保新版本 Rust 工具链优先被调用。

  • 后续验证

    通过运行以下命令验证环境:

    复制代码
    rustup show
    rustc --version
    cargo --version

    如果输出符合预期(例如显示 Rust 1.87.0),则说明升级和配置已成功。


总结

在旧版 MSYS2(安装在 D 盘)中,由于自带的 Rust 版本较旧以及 PATH 环境变量的限制,导致了构建 Rust 依赖失败的问题。通过手动下载安装 Rustup,并在 MSYS2 中调整 PATH 变量,让系统使用 Rustup 管理的新工具链,最终成功升级到 Rust 1.87.0,从而解决了编译依赖的问题。

这份笔记记录了整个处理过程和关键步骤,供未来参考和类似环境下的故障排查使用。

如果今后遇到其它问题,也可以依此方法进行详细的排查和处理。

相关推荐
机器人行业研究员5 分钟前
蓝点触控:力觉是机器人“稳不稳、准不准”的关键
人工智能·机器人
一口面条一口蒜18 分钟前
R语言中的S3 泛型与方法
开发语言·r语言
央链知播22 分钟前
王玉真:可信资产与数链金融的核心根基——构建全链路可信信用体系
人工智能·金融·重构·web3·区块链·业界资讯
共饮一杯无25 分钟前
在 Windows 系统上怎么使用rabbitmq相关命令,比如:rabbitmqctl list_queues 命令
windows·rabbitmq·rabbitmq命令
路人与大师27 分钟前
AI Agent的演进之路:从检索增强到世界模型的六代变革
人工智能
szxinmai主板定制专家29 分钟前
ZYNQ 平台下的四声道超声流量计设计与实现
运维·arm开发·人工智能·分布式·fpga开发
_OP_CHEN31 分钟前
C++基础:(五)类和对象(下)—— static、友元和内部类
开发语言·c++·构造函数·static成员·友元·匿名对象·编译器优化
databook32 分钟前
Manim实现闪电特效
后端·python·动效
码猩34 分钟前
YOLO通用无人机目标检测框架
人工智能·yolo·目标检测
yongui4783437 分钟前
基于MATLAB的8QAM调制解调仿真与BER性能分析
开发语言·matlab