MSYS2 国内镜像加速：三步切换清华/中科大源，下载提速 1000 倍

摘要：MSYS2 默认源在国外，国内下载慢到崩溃。本文教你三步切换清华源/中科大源，让 pacman 加速 1000 倍，5 分钟配好，适合 Windows 下使用 MSYS2 的开发者。

三步切换镜像

国内镜像加速——解决 pacman 下载慢

MSYS2 的默认软件源在德国和日本——国内直接下载速度可能只有 10 KB/s。安装 200MB 的 arm-none-eabi-gcc 要等几个小时。切换到国内镜像后只需几十秒。

本课目标

• 会配置清华/中科大 MSYS2 镜像源

• 理解 mirrorlist 文件的优先级机制

• 配置后验证下载速度

三步切换国内镜像

💡 备选镜像清华挂了用中科大：https://mirrors.ustc.edu.cn/msys2/mingw/$repo/。——用法完全一样，替换 URL 即可。

mirrorlist 文件的工作原理

pacman 下载软件时——按 mirrorlist 文件中的顺序依次尝试。第一个响应的 Server 被使用。所以清华源排在第一位 = 优先使用清华源。

本页大纲：三步切换镜像

① 为什么下载慢（默认走国外源）→ ② 三步切换全景 → ③ 清华/中科大镜像对比 → ④ 交互：镜像切换模拟 → ⑤ 速度实测对比

🐢 为什么 pacman 下载慢得让人崩溃？

MSYS2 的默认镜像服务器在国外。国内网络访问时，速度通常只有10-100 KB/s——安装 gcc 要下载 98.5 MiB，意味着你要等20-160 分钟。更糟的是经常连接超时、中途断线，一切重来。这不是你的网络问题，是物理距离问题。

🔄 三步切换全景——从"慢"到"快"只需三下

🏆 清华 vs 中科大——两大镜像怎么选

💡 选择建议先试清华；如果下载报错（偶尔同步问题），把中科大地址放第一行即可切换。两个都写进文件，pacman 会自动按顺序尝试。

📊 速度实测对比表——LKS32 安装过程的真实数据

💡 结论切换镜像不是"优化"，是*“从不可用到可用”*。没有镜像加速，你在国内几乎无法流畅使用 MSYS2——这是环境搭建的必备步骤，不是可选项。

💡 一句话总览镜像加速 =把"下载入口"从国外搬到国内。三步切换（找文件→贴地址→验证），5 分钟配置，之后下载快 1000 倍——这是整个环境搭建里"性价比最高"的一步。

🌐 国内常见 MSYS2 镜像一览——选择多多

💡 选哪个都行核心是"国内 + https + 同步及时"。本教程用清华（最流行、资料最多），中科大/阿里云作为备用。如果某个源偶尔抽风，把另一个放第一行即可。

📡 镜像同步机制——为什么镜像"几乎最新"

📋 镜像切换的完整命令清单——复制即用

# ===== 备份 ===== cp /etc/pacman.d/mirrorlist.mingw{,.bak} cp /etc/pacman.d/mirrorlist.msys{,.bak} # ===== 写入清华 + 中科大（mingw 文件） ===== cat > /etc/pacman.d/mirrorlist.mingw < # ===== 写入清华 + 中科大（msys 文件） ===== cat > /etc/pacman.d/mirrorlist.msys < # ===== 刷新 ===== pacman -Sy

💡 脚本的好处一条条 echo 容易漏；用 cat heredoc 一次写多行，两个镜像都配上。清华挂了自动用中科大，双保险。

🎯 镜像配置 FAQ——安装期最常见的问题

🔄 恢复默认源——用备份一键还原

# 之前备份过 .bak，恢复只需两步 $ cp /etc/pacman.d/mirrorlist.mingw.bak /etc/pacman.d/mirrorlist.mingw $ cp /etc/pacman.d/mirrorlist.msys.bak /etc/pacman.d/mirrorlist.msys # 刷新数据库 $ pacman -Sy # 如果没备份：重装 MSYS2 或从官网下载默认 mirrorlist

💡 这就是备份的价值改配置前备份是好习惯——出问题 5 秒还原，不用重装系统。以后改任何系统配置都建议先备份。

🎯 镜像切换的完整演练——从零到一百

# ① 确认当前状态：默认源 $ cat /etc/pacman.d/mirrorlist.mingw | head -3 Server = https://mirror.msys2.org/mingw/ucrt64 Server = https://mirror.rackspace.com/msys2/mingw/ucrt64 Server = https://mirrors.kernel.org/msys2/mingw/ucrt64 # ② 备份 $ cp /etc/pacman.d/mirrorlist.mingw /etc/pacman.d/mirrorlist.mingw.bak $ cp /etc/pacman.d/mirrorlist.msys /etc/pacman.d/mirrorlist.msys.bak # ③ 写清华（两文件） $ echo 'Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/ucrt64' > /etc/pacman.d/mirrorlist.mingw $ echo 'Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/msys/$arch' > /etc/pacman.d/mirrorlist.msys # ④ 刷新验证 $ pacman -Sy :: 正在同步软件包数据库... 完成 ← 秒级 = 成功！ # ⑤ 装个包实测（可选） $ pacman -S mingw-w64-ucrt-x86_64-gdb-multiarch 12.4 MiB 38.2 MiB/s 00:00 ← MB/s 级 = 完全生效

💡 五步演练的意义这是完整闭环：查看现状 → 备份 → 写地址 → 刷新 → 实测。以后任何机器（新电脑/同事电脑）都能按这五步 5 分钟配好。

💡 镜像之外的下载加速——J-Link/STM32Cube 等软件怎么加速

💡 本课核心思想再强调镜像加速解决的是"包管理器下载"这一环。其他软件的下载是独立问题，但思路一样：找国内源/代理。第 41 课装 J-Link 时会有具体建议。

📌 本课速记卡——镜像加速三句话

🧠 镜像原理十问——彻底吃透"下载加速"这件事

🛡️ 切换镜像的"后悔药"——三种还原方式

💡 心态建议改配置没那么可怕——最坏情况是重装 MSYS2（10 分钟）。有了备份+多个源+重装三重保险，大胆试错。

💡 环境毕业纪念第 05-08 课全部完成——你的 Windows ARM 开发环境正式"毕业"。从下一课开始，不再装工具，开始学真本事：CMake 语法！

详细编辑步骤

详细的文件编辑步骤

编辑 mirrorlist 文件不需要特殊工具——用记事本或 VSCode 即可。

步骤 1：编辑 mirrorlist.mingw

用任意文本编辑器打开C:\msys64\etc\pacman.d\mirrorlist.mingw：

## MSYS2 repository mirrorlist ## Primary Server = https://repo.msys2.org/mingw/$repo/ ## Tier 1 Server = https://mirror.yandex.ru/mirrors/msys2/mingw/$repo/ ... (德国、俄罗斯等国外源)

## MSYS2 repository mirrorlist ## Primary — 国内镜像（优先级最高） Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/$repo/ Server = https://mirrors.ustc.edu.cn/msys2/mingw/$repo/ ## Fallback Server = https://repo.msys2.org/mingw/$repo/ ... (其他源保留为备选)

步骤 2：编辑 mirrorlist.msys（同样操作）

## MSYS2 repository mirrorlist Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/msys/$arch/ Server = https://mirrors.ustc.edu.cn/msys2/msys/$arch/ ## Fallback Server = https://repo.msys2.org/msys/$arch/

注意：mirrorlist.clang64 也要改（如果你用 Clang）

LKS32 项目不需要——我们用的是 GCC。但如果你在 MSYS2 中装过其他工具，也建议把mirrorlist.clang64和mirrorlist.ucrt64一起改了。

本页大纲：详细编辑步骤

① mirrorlist 文件结构解析 → ② 完整编辑命令 → ③ 修改前后对比 → ④ 交互：编辑模拟 → ⑤ 常见编辑错误

📂 两个 mirrorlist 文件——谁管什么

MSYS2 的镜像配置分散在C:\msys64\etc\pacman.d\下的两个文件里，各自管不同的包：

💡 关键你安装的 GCC/CMake/Ninja 都属于 *mingw-w64-ucrt-x86_64-，由 mirrorlist.mingw 管——这个必须改。mirrorlist.msys 管基础工具，建议一起改，否则 pacman -Syu 升级基础包时还是慢。

✏️ 完整编辑命令——复制粘贴即可

# ① 备份原文件（好习惯！） $ cp /etc/pacman.d/mirrorlist.mingw /etc/pacman.d/mirrorlist.mingw.bak $ cp /etc/pacman.d/mirrorlist.msys /etc/pacman.d/mirrorlist.msys.bak # ② 清华镜像地址（写入文件顶部） $ echo 'Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/ucrt64' > /etc/pacman.d/mirrorlist.mingw $ echo 'Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/msys/$arch' > /etc/pacman.d/mirrorlist.msys # ③ 刷新包数据库 $ pacman -Sy :: 正在同步软件包数据库... 完成 ← 秒级完成 = 镜像生效

💡 注意地址差异两个文件的 URL 结尾不同：mingw 文件用 /mingw/ucrt64，msys 文件用 /msys/$arch——写错任何一个，那个文件对应的包就装不了。

🔀 修改前后对比——同一文件两种命运

# 默认内容（国外镜像列表） # ## MSYS2 mirrorlist Server = https://mirror.msys2.org/mingw/ucrt64 Server = https://mirror.rackspace.com/msys2/mingw/ucrt64 Server = https://mirrors.kernel.org/msys2/mingw/ucrt64 Server = https://mirrors.tripadvisor.com/msys2/mingw/ucrt64 ... 10+ 个国外镜像

# 清华放第一行（优先使用） Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/ucrt64 # 中科大放第二行（备用） Server = https://mirrors.ustc.edu.cn/msys2/mingw/ucrt64 # 原国外镜像保留在下面（兜底） Server = https://mirror.msys2.org/mingw/ucrt64 ...

💡 优先级机制pacman 从第一行开始逐个尝试——第一行可用就用它。所以把国内镜像放最上面，国外镜像留在下面当"备胎"。这就是第 08 课"优先级"的精髓。

⚠️ 常见编辑错误——五连坑避雷

💡 本页小结编辑镜像的完整闭环：备份 → 写地址（两个文件）→ 刷新（pacman -Sy）→ 验证速度。地址格式是最大坑，记住 /mingw/ucrt64 vs /msys/$arch 的差异。

💡 一句话总览编辑镜像 =改两个文件 + 一行刷新。备份是好习惯，地址格式是重点，优先级机制（第一行优先）是精髓——掌握这些，镜像配置一次成功。

📝 手动编辑教程——不用命令行的替代方案

如果你不习惯用 echo/cat 写文件，也可以用记事本手动编辑：

💡 记事本注意保存时编码保持默认（UTF-8 无 BOM 最好）——不要另存为 UTF-16，否则 pacman 读取会乱码。如果保存后 pacman 报错，多半是编码问题。

🔍 深入：mirrorlist 文件格式解析

# 注释行：以 # 开头，pacman 忽略 # ## MSYS2 mingw64 mirrorlist # 服务器行：Server = URL，$arch 会被替换为架构名 Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/ucrt64 # 上面这行的含义： # Server = 固定前缀 # https://... 镜像地址 # /mingw/ucrt64 指向 UCRT64 包的目录 # pacman 会在该 URL 下找 db 文件和包文件

💡 理解 Server 行pacman 读取镜像列表时，会按行从上到下逐个尝试：第一个连得上的就用它。所以"第一行优先"= 国内镜像放最上面，国外放下面兜底。

🛠️ 排错专项——改了镜像还是不快的五种情况

🔀 heredoc 方式 vs echo 方式——两种写文件方法对比

🛠️ 镜像地址的完整写法——五条通用模板

# 清华 TUNA Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/ucrt64 Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/msys/\$arch # 中科大 USTC Server = https://mirrors.ustc.edu.cn/msys2/mingw/ucrt64 Server = https://mirrors.ustc.edu.cn/msys2/msys/\$arch # 阿里云 Server = https://mirrors.aliyun.com/msys2/mingw/ucrt64 Server = https://mirrors.aliyun.com/msys2/msys/\$arch # 腾讯云 Server = https://mirrors.cloud.tencent.com/msys2/mingw/ucrt64 Server = https://mirrors.cloud.tencent.com/msys2/msys/\$arch # 南京大学 Server = https://mirror.nju.edu.cn/msys2/mingw/ucrt64 Server = https://mirror.nju.edu.cn/msys2/msys/\$arch

💡 规律所有镜像的 URL 结构都是 https://<镜像域名>/msys2/mingw/ucrt64——只需换域名，路径固定。记住这个规律，任何镜像 3 秒配好。

🧠 镜像配置的"心智模型"——一次理解终身受用

🧪 验证地址是否可用的技巧——配置前先测

# 测试清华镜像的 mingw 路径是否可访问 $ curl -I https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/ucrt64/ HTTP/2 200 ← 200 = 可访问 date: ... server: nginx # 测试 msys 路径 $ curl -I https://mirrors.tuna.tsinghua.edu.cn/msys2/msys/x86_64/ HTTP/2 200 ← 200 = 可访问

💡 为什么先测？避免"写进配置文件才发现地址错"。curl -I 5 秒验证 URL，返回 200 再写入 mirrorlist——一次成功，不来回折腾。

📊 mirrorlist 配置对比——国内源 vs 官方源的取舍

💡 安全性说明MSYS2 的所有包都有GPG 签名校验——无论从哪个镜像下载，校验不过都会拒绝安装。所以用国内镜像不降低安全性，放心用。

🔍 pacman.conf 里的相关配置——镜像之外还有两个提速点

# 开启彩色输出（看得更清楚） Color # 并行下载（同时下载多个包，提速明显） ParallelDownloads = 5 ← 默认 1，改成 5+ 提速 # 保持已下载的包（缓存复用，重装不用重下） #CacheDir # 默认缓存：/var/cache/pacman/pkg/

💡 ParallelDownloads 是隐藏提速点镜像解决了"单包下载慢"，并行下载解决"多包下载排队"——两个都配上，装工具链体验直接起飞。改完 pacman -Sy 生效。

📋 镜像配置检查清单——配完逐项打勾