配置：hfd 开发的 huggingface 专用下载工具，基于成熟工具 aria2

配置环境（这里采用vscode）

安装git（可选）

配置

这里用vscode，就勾选Use Visual Studio Code as Git's default editor

这是 Git 2.49.0 安装时 “设置新仓库初始分支名称” 的配置界面，关键实体：

选项 1：Let Git decide（默认用 Git 当前默认名，目前多为 master ，但 Git 计划未来换更包容名称）
选项 2：Override...（手动指定新仓库初始分支名，常见填 main ，很多团队已用此替代 master ）

从 通用性和适配主流规范 角度，选 Override the default branch name... 并填 main （和 GitHub/GitLab 等平台默认分支名对齐，减少后续仓库分支名不一致的麻烦），选完点 Next 继续安装即可。

这是 Git 2.49.0 安装时 “配置 PATH 环境变量” 的选项界面，3 个核心选项实体：

Use Git from Git Bash only：仅 Git Bash 可用，不修改系统 PATH
Git from the command line and also from 3rd-party software（推荐）：给命令行（CMD/PowerShell）和第三方软件（如 VS Code）配 Git 路径，最通用
Use Git and optional Unix tools from the Command Prompt：会覆盖系统工具（如 find/sort ），不推荐

结合你要用 VS Code + Git Bash 协同工作 的需求，选 第二个选项（推荐项） ，让 Git 能被命令行和第三方软件识别，装完点 Next 继续即可。

选 Use bundled OpenSSH 用 Git 自带的 OpenSSH（稳定、无需额外配置，推荐）

保持默认选 Use the native Windows Secure Channel library 即可，点 Next 继续安装。

Checkout Windows-style, commit Unix-style（默认选中）：检出时 LF 转 CRLF，提交时 CRLF 转 LF，适配 Windows 跨平台开发（推荐）

保持选 Use MinTTY ，点 Next 继续安装即可。

结合日常开发（兼顾兼容性和少冲突），保持默认选 Fast-forward or merge

Git Credential Manager（默认选中）：跨平台凭据管理工具，自动保存 Git 账号密码（推荐，适配 GitHub/GitLab 等）

最后勾选这个安装成功

打开vscode，在终端输入 git --version ，若返回 Git 版本号（如 git version 2.49.0 ），说明安装成功；若提示 “命令未找到”，则需检查 Git 安装及环境变量配置。

配置hfd下载工具

官方步骤

# 下载 hfd.sh 脚本
wget https://hf-mirror.com/hfd/hfd.sh  
# 赋予脚本可执行权限（Linux/Mac/WSL 需执行，Windows Git Bash 也需）
chmod a+x hfd.sh  #如果报错直接用 bash hfd.sh ... 执行脚本，简单有效，无需纠结权限问题
#设置环境变量 HF_ENDPOINT（指定镜像加速地址）
$env:HF_ENDPOINT = "https://hf-mirror.com"  
#如果用 Git Bash 终端，执行：
export HF_ENDPOINT=https://hf-mirror.com

git步骤

注意如果安装了git，这里有两个终端

# 在 PowerShell（不是 Git Bash）里执行
Invoke-WebRequest -Uri https://hf-mirror.com/hfd/hfd.sh -OutFile D:\code\2025\6\26\hfd.sh
bash hfd.sh #... 执行脚本，简单有效，无需纠结权限问题

简单说：用 PowerShell 下载脚本到指定路径，再用 Git Bash 执行

#用 PowerShell 下载脚本：
Invoke-WebRequest -Uri https://hf-mirror.com/hfd/hfd.sh -OutFile D:\code\2025\6\26\hfd.sh
#切回 Git Bash，先确认脚本存在（ls hfd.sh ），再执行：
#设环境变量（Git Bash 里用 export 是对的，确保环境加载）
export HF_ENDPOINT=https://hf-mirror.com
#运行脚本
bash hfd.sh