【笔记】旧版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,从而解决了编译依赖的问题。

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

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

相关推荐
AI生存日记5 分钟前
百度文心大模型 4.5 系列全面开源 英特尔同步支持端侧部署
人工智能·百度·开源·open ai大模型
wuk9988 分钟前
基于MATLAB编制的锂离子电池伪二维模型
linux·windows·github
浪裡遊25 分钟前
React Hooks全面解析:从基础到高级的实用指南
开发语言·前端·javascript·react.js·node.js·ecmascript·php
LCG元28 分钟前
自动驾驶感知模块的多模态数据融合:时序同步与空间对齐的框架解析
人工智能·机器学习·自动驾驶
why技术32 分钟前
Stack Overflow,轰然倒下!
前端·人工智能·后端
烛阴1 小时前
简单入门Python装饰器
前端·python
lzb_kkk1 小时前
【C++】C++四种类型转换操作符详解
开发语言·c++·windows·1024程序员节
超龄超能程序猿1 小时前
(三)PS识别:基于噪声分析PS识别的技术实现
图像处理·人工智能·计算机视觉
要努力啊啊啊1 小时前
YOLOv3-SPP Auto-Anchor 聚类调试指南!
人工智能·深度学习·yolo·目标检测·目标跟踪·数据挖掘