资料修改2026-09尚无逐条事实核验记录；修改日期不代表已验证
本文仍包含未全面复核的历史资料；安装、许可、费用与当前权限请回到官方确认。查看已核信息范围
Hugging Face 与国内镜像
Hugging Face（https://huggingface.co）是全球最大的模型托管站，绝大多数开源模型的权重都在这里发布。国内直连速度慢且时好时坏，社区维护的镜像站 hf-mirror.com 与官方数据同步，可替代下载。
用法：一个环境变量
主流工具链（huggingface-cli、transformers、diffusers 等）读取 HF_ENDPOINT 环境变量，设为镜像地址即可生效：
# Linux / macOS
export HF_ENDPOINT=https://hf-mirror.com
# Windows PowerShell（仅当次会话）
$env:HF_ENDPOINT = "https://hf-mirror.com"
Windows 想永久生效：在系统环境变量里添加 HF_ENDPOINT，或执行 setx HF_ENDPOINT https://hf-mirror.com 后重开终端。
下载命令
pip install -U huggingface_hub
huggingface-cli download 模型名 --local-dir ./模型目录
社区实测镜像下载速度可达 8-12 MB/s，见 hf-mirror 官网与腾讯云开发者社区教程。
互补选择：魔搭 ModelScope
国内还有阿里运营的魔搭 ModelScope（https://modelscope.cn），国内速度最快，主流国产模型都有官方仓库，直达入口见模型权重直达。
⚠️ 避坑：个别网络环境下与镜像握手会失败，此时切回官方源（或换魔搭）反而能通——两个通道都试，哪个通用哪个。
⚠️ 避坑：大模型动辄几 GB，
--local-dir明确指定存放目录，避免默认下进 C 盘用户缓存。