本文详细介绍了在 macOS 系统中永久设置 Hugging Face 镜像站环境变量的方法，以加速模型下载速度。首先，确认当前使用的 Shell 类型，然后根据 Shell 类型修改对应的配置文件（.zshrc 或 .bash_profile/.bashrc）。文章提供了设置 Hugging Face 镜像站环境变量的具体步骤，包括配置 HF_ENDPOINT、HF_HUB_DOWNLOAD_URL 和 TRANSFORMERS_CACHE，并说明如何保存和使配置生效。此外，还介绍了清华、阿里云和 bfsu 等镜像站的配置方法，以及多用户环境、优先级和临时覆盖等注意事项。通过这些配置，用户可以更高效地使用 Hugging Face 相关的工具。

🔍 **确认 Shell 类型**: 首先，通过 `echo $SHELL` 命令确认当前 macOS 系统使用的 Shell 类型。如果输出为 `/bin/zsh`，则使用 `.zshrc` 文件进行配置；如果输出为 `/bin/bash`，则使用 `.bash_profile` 或 `.bashrc` 文件。

📝 **编辑配置文件**: 根据 Shell 类型，使用 `open -e ~/.zshrc` (Zsh) 或 `open -e ~/.bash_profile` (Bash) 命令打开相应的配置文件。如果文件不存在，则会自动创建。

💡 **添加环境变量**: 在配置文件末尾添加 Hugging Face 镜像站的环境变量。例如，使用清华镜像站时，添加以下内容：`export HF_ENDPOINT="https://hf-mirror.com"`、`export HF_HUB_DOWNLOAD_URL="https://hf-mirror.com"` 和 `export TRANSFORMERS_CACHE="$HOME/.cache/huggingface/transformers"`。其中，`HF_ENDPOINT` 指定 API 端点，`HF_HUB_DOWNLOAD_URL` 指定模型下载地址，`TRANSFORMERS_CACHE` 指定模型缓存路径。

🔄 **使配置生效**: 保存配置文件后，在终端执行 `source ~/.zshrc` (Zsh) 或 `source ~/.bash_profile` (Bash) 命令，或者重启终端，使配置生效。

✅ **验证配置**: 通过执行 `echo $HF_ENDPOINT` 命令验证环境变量是否正确设置。如果输出镜像站的 URL，则配置成功。

🌐 **其他镜像站选项**: 除了清华镜像站，还可以使用阿里云镜像站和 bfsu 镜像站。文章提供了这两种镜像站的配置示例，用户可以根据自己的需求进行选择。

在 macOS 系统中永久设置 Hugging Face 镜像站的环境变量，可通过修改 Shell 配置文件实现。以下是具体步骤：

一、确认当前使用的 Shell

打开终端，执行以下命令查看当前 Shell：

echo $SHELL

若输出为/bin/zsh（macOS 默认）：使用.zshrc文件。若输出为/bin/bash：使用.bash_profile或.bashrc文件。

二、设置 Hugging Face 镜像站环境变量

以下以 Zsh（默认） 为例，介绍如何设置：

1. 打开配置文件

open -e ~/.zshrc

若文件不存在，会自动创建。

2. 添加环境变量

在文件末尾添加以下内容（以清华镜像站为例）：

bash

# Hugging Face 镜像站配置export HF_ENDPOINT="https://hf-mirror.com"export HF_HUB_DOWNLOAD_URL="https://hf-mirror.com"export TRANSFORMERS_CACHE="$HOME/.cache/huggingface/transformers"

HF_ENDPOINT：指定 API 端点为镜像站。HF_HUB_DOWNLOAD_URL：指定模型下载地址为镜像站。TRANSFORMERS_CACHE：指定模型缓存路径（可选）。

3. 保存并使配置生效

关闭文件后，在终端执行：

source ~/.zshrc

或重启终端。

三、验证配置是否生效

执行以下命令查看环境变量是否正确设置：

echo $HF_ENDPOINT

若输出https://hf-mirror.com，则配置成功。

四、其他镜像站选项

除了清华镜像站，还可以使用以下镜像：

阿里云镜像：

export HF_ENDPOINT="https://mirror.aliyun.com/huggingface"export HF_HUB_DOWNLOAD_URL="https://mirror.aliyun.com/huggingface"

bfsu 镜像：

bash

export HF_ENDPOINT="https://mirrors.bfsu.edu.cn/hugging-face-models"export HF_HUB_DOWNLOAD_URL="https://mirrors.bfsu.edu.cn/hugging-face-models"

五、注意事项

多用户环境：若需所有用户共享配置，可将环境变量添加到/etc/profile或/etc/zshrc（需sudo权限）。

优先级：若同时设置多个镜像站，最后设置的生效。

临时覆盖：若需临时使用官方源，可在命令前临时指定：

HF_ENDPOINT="https://huggingface.co" python your_script.py

通过以上配置，后续使用 Hugging Face 相关工具（如transformers库）时，将自动从镜像站下载模型，大幅提升速度。