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

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

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

相关推荐
我真的是大笨蛋24 分钟前
K8S-Pod(下)
java·笔记·云原生·容器·kubernetes
昨日之日20061 小时前
Wan2.2-S2V - 音频驱动图像生成电影级质量的数字人视频 ComfyUI工作流 支持50系显卡 一键整合包下载
人工智能·音视频
一个天蝎座 白勺 程序猿2 小时前
Python爬虫(47)Python异步爬虫与K8S弹性伸缩:构建百万级并发数据采集引擎
爬虫·python·kubernetes
XiaoMu_0013 小时前
基于Django+Vue3+YOLO的智能气象检测系统
python·yolo·django
SEO_juper3 小时前
大型语言模型SEO(LLM SEO)完全手册:驾驭搜索新范式
人工智能·语言模型·自然语言处理·chatgpt·llm·seo·数字营销
攻城狮7号4 小时前
腾讯混元翻译模型Hunyuan-MT-7B开源,先前拿了30个冠军
人工智能·hunyuan-mt-7b·腾讯混元翻译模型·30个冠军
zezexihaha4 小时前
从“帮写文案”到“管生活”:个人AI工具的边界在哪?
人工智能
算家云4 小时前
nano banana官方最强Prompt模板来了!六大场景模板详解
人工智能·谷歌·ai大模型·算家云·ai生图·租算力,到算家云·nano banana 提示词
暴躁的大熊4 小时前
AI助力决策:告别生活与工作中的纠结,明析抉择引领明智选择
人工智能
Gyoku Mint4 小时前
提示词工程(Prompt Engineering)的崛起——为什么“会写Prompt”成了新技能?
人工智能·pytorch·深度学习·神经网络·语言模型·自然语言处理·nlp