mac系统下永久设置环境变量之【huggingface更换镜像站】

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

一、确认当前使用的 Shell

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

bash 复制代码

echo $SHELL

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

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

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

1. 打开配置文件

bash 复制代码

open -e ~/.zshrc

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

2. 添加环境变量

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

bash

ini 复制代码

# 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. 保存并使配置生效

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

bash 复制代码

source ~/.zshrc

或重启终端。

三、验证配置是否生效

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

bash 复制代码

echo $HF_ENDPOINT

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

四、其他镜像站选项

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

阿里云镜像：

bash 复制代码

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

bfsu 镜像：

bash

ini 复制代码

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权限）。
优先级：若同时设置多个镜像站，最后设置的生效。
临时覆盖：若需临时使用官方源，可在命令前临时指定：
bash 复制代码
```
HF_ENDPOINT="https://huggingface.co" python your_script.py
```

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