Miniconda清华镜像源配置教程-Python教程-PHP中文网

不配清华镜像源，conda install 会卡在 solving environment... 超过10分钟甚至失败；配完后下载速度基本满带宽，gdal、rasterio等遥感gis库安装成功率从不到50%升至近100%，因清华源覆盖全、响应快，且需配合 channel_priority: flexible 和 conda clean --all -y 等关键步骤确保生效。

miniconda清华镜像源配置教程

直接说结论：不配清华镜像源，conda install 会卡在 Solving environment... 超过10分钟，甚至失败；配完后下载速度基本满带宽，遥感、GIS 类库（如 gdal、rasterio）安装成功率从不到50%升到接近100%。

为什么 `conda config --add channels` 容易出错

很多人逐条执行 conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ 等命令，结果发现 conda install 仍走默认境外源——根本原因是 Conda 的 channel 优先级机制没被正确触发。

常见错误现象：

执行完四条 conda config --add channels 后，conda config --show channels 显示的仍是 defaults（即境外源）
安装时提示 Collecting package metadata (current_repodata.json): ... done，但耗时极长，且实际连接的是 repo.anaconda.com

真正起效的关键不是“加了哪些源”，而是“谁排第一”和“是否关闭严格优先级”。必须补上这两步：

conda config --remove-key channels（先清空所有已有源，避免旧配置干扰）
conda config --set channel_priority flexible（否则 Conda 默认 strict 模式，只认 defaults，无视你后加的清华地址）
conda config --set show_channel_urls yes（安装时能看到当前用的是哪个 URL，方便排错）

`.condarc` 文件手动编辑更稳

命令行配置看似快，但 Windows 下权限问题、终端缓存、多用户环境都可能导致配置没写进用户级文件。直接改 .condarc 是最可靠的落地方式。

路径位置：

Windows：C:\Users\{用户名}\.condarc
macOS/Linux：~/.condarc

用任意文本编辑器（如记事本、VS Code）打开，**完全替换为以下内容**（注意缩进是空格，不是 Tab）：

channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2/
show_channel_urls: true
channel_priority: flexible

保存后，在新终端里运行 conda config --show channels，输出应只有上述清华地址，且顺序一致。

Miniconda Linux版

Miniconda py314_26.5.3-2 Linux x86_64 安装脚本，来自 Anaconda 官方 Miniconda 下载目录，适合服务器、工作站和容器环境配置轻量 Conda 与 Python。

下载

conda-forge 为什么必须加，且要放靠前位置

遥感、地理信息类库（gdal、rasterio、pyproj）绝大多数只在 conda-forge 提供预编译二进制包。官方 defaults 源里要么没有，要么版本老旧、依赖缺失。

如果你把 conda-forge 放在最后，Conda 在 main 或 free 找不到包时才会去它那儿查——但很多包压根不在前几个源里，导致报错 PackageNotFoundError。

所以必须确保：

https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ 出现在 channels 列表中，且位置尽量靠前（建议第3位）
不要用 conda config --add channels conda-forge 单独加——它会加到列表末尾，且不带清华镜像前缀，等于白加

验证方法：运行 conda search -c conda-forge rasterio，有返回结果即说明 conda-forge 可达。