Windows 操作系统中的 Rust 程序,预设会使用 MSVC 来编译的。但是如果 Rust 程序有使用到 GNU 相关的函数库(例如 GTK)时,就得搭配 MinGW 来编译了。MSYS2 是一套集成 MinGW 和 POSIX 环境的工具,可以在 Windows 操作系统上模拟出 Linux 操作系统的开发环境,且能利用 MinGW 直接编译出在 Windows 操作系统上运行的程序。

安装与设置 MSYS2

参考这篇文章来安装与设置 MSYS2:

在 Windows 操作系统安装 Rust 开发环境

如果您的 Windows 操作系统已经有 Rust 的开发环境(在命令提示字符下可以直接使用 rustup、cargo 等指令),可以跳过这个部份。

首先在 MSYS2 的终端机上运行以下指令来用 rustup 安装 Rust 的开发工具:

curl -fsSL https://sh.rustup.rs | sh -s

安装档可能会提示说需要微软的 Visual C++ Build Tools。这时选择第三个选项不让 rustup 帮我们自动安装这些微软的东西。

rustup 提示需要 Visual C++ Build Tools

选择第二个选项来自订 Rust 要如何安装。

选择自订安装

host triple 的部份,输入 x86_64-pc-windows-gnu,也就是我们的 Rust 编译器预设使用的目标(target)名称。

输入 x86_64-pc-windows-gnu 作为 host triple

接着输入 Rust 的版本,建议直接按下 Enter 使用 stable,如果有 nightly 需求的话就输入 nightly 吧!

选择 stable 版本

选择要进行多完整的安装,用预设即可。

选择安装的完整程度

接着设置是否要修改 PATH 环境变量,输入 y。

设置修改 PATH 环境变量

然后回到菜单,选择第一项,开始用我们刚才的设置来安装 Rust。

设置完成后的安装选项

开始下载 Rust 组件

Rust 安装完成

安装好后,确认 PATH 环境变量是否有包含 %USERPROFILE%\.cargo\bin 路径,没有的话就加上去。

确认 PATH 环境变量包含 .cargo 的 bin 路径

在 MSYS2 的终端机中设置 Rust 开发环境

在命令提示字符中输入 rustup 和 cargo 指令来确认 Windows 操作系统的 Rust 开发环境是否安装且设置成功。如果有设置成功,指令才会存在。

在命令提示字符确认 rustup 与 cargo

确认好 Windows 操作系统已经正确地弄好 Rust 开发环境后,可以在 MSYS2 的终端机中,再运行 rustup 和 cargo 指令。您可能会发现 MSYS2 的终端机并无法使用 rustup 和 cargo 指令。

MSYS2 终端机找不到 rustup 指令

此时可以在 MSYS2 的终端机中利用以下指令来查看 PATH 环境变量:

echo $PATH

在 MSYS2 以 echo $PATH 查看环境变量

如果没看到 PATH 环境变量中有包含 /c/Users/您的Windows用户名/.cargo/bin 的话,我们就得按照以下方法自行加进去。

利用 vim 等文字编辑软件,打开 MSYS2 的终端机家目录中的 .bashrc 文件。如果目前的工作目录已经是家目录了,指令如下:

vim .bashrc

以 vim 打开 .bashrc

修改 .bashrc 的内容,将 /c/Users/您的Windows用户名/.cargo/bin 加入至 PATH 环境变量中。如下图:

将 .cargo/bin 加入 PATH 环境变量

存盘后,在 MSYS2 的终端机的家目录中运行以下指令,来套用修改后的「PATH」环境变量。

source .bashrc

以 source 套用 .bashrc

之后就可以在 MSYS2 的终端机中使用 rustup 和 cargo 等 Rust 开发环境的相关指令了!

在 MSYS2 中使用 cargo 指令

替 Rust 加入 x86_64-pc-windows-gnu 目标

如果您在安装 Rust 的时候已经设置使用了 x86_64-pc-windows-gnu 目标,可以跳过这个部份。

在 MSYS2 的终端机中使用以下指令,来查看 Rust 开发环境目前已安装的工具链,工具链名称的后半段就是它预设使用的目标:

rustup toolchain list

以 rustup toolchain list 查看已安装的工具链

如果工具链的名称不是以 x86_64-pc-windows-gnu 结尾的话,可以使用以下指令来替目前的工具链加入这个目标(之后可以用 rustup target list --installed 指令来确认已加入的目标):

rustup target add x86_64-pc-windows-gnu

加入 x86_64-pc-windows-gnu 目标

让 Rust 使用 MSYS2 的 MinGW

当我们使用 rustup 安装 x86_64-pc-windows-gnu 目标时,rustup 会替我们加上 rust-mingw 这个组件,内有 Rust 自带的 MinGW 工具链。若要替换成我们刚才使用 MSYS2 所安装的 MinGW 工具链的话,可以在 MSYS2 的终端机中使用 vim 等文字编辑软件,打开 /c/Users/您的Windows用户名/.cargo/config 文件。

以 vim 打开 .cargo/config

在文件内加上以下内容:

[target.x86_64-pc-windows-gnu]
linker = "C:\\msys64\\mingw64\\bin\\gcc.exe"
ar = "C:\\msys64\\mingw64\\bin\\ar.exe"

设置使用 MSYS2 MinGW 的 linker 与 ar

如此一来,不论是哪个 Cargo 程序项目,在使用 x86_64-pc-windows-gnu 目标来编译程序时,就会去用 MSYS2 的 MinGW 提供的 gcc.exe 和 ar.exe 来做函数库的链接。

Rust 与 MSYS2 的 Hello World

为了确定我们的 Rust 开发环境没有问题,可以在 MSYS2 的终端机中,使用以下几个指令来测试预设的 Cargo 程序项目(Hello World)是否可以正常被编译运行。

cargo new --bin hello
cd hello
cargo run

在 MSYS2 编译运行 Hello World 项目