下载与管理模型文件

适用版本: 1.0.1iPad · iPhone内容核对日期: 2026-09-21截图界面: 简体中文Standard / Pro

设备

你将完成什么

先验证小型 Hugging Face 文件下载，再尝试大型模型。

开始前准备

有效的 Standard、Pro 订阅，或符合条件的试用。
能够连接本教程所用服务或下载资源的网络。
若资源要求身份验证，需要 Hugging Face 账号和具有所需权限的 Token。

下载教程示例项目

从哪里进入

Notebook → huggingface_hub

逐步操作

import json
try:
    from huggingface_hub import hf_hub_download
    path = hf_hub_download("google-bert/bert-base-uncased", "config.json",
                           token=True, force_download=True)
    with open(path) as config_file:
        config = json.load(config_file)
    print("Configuration downloaded:", config.get("model_type") == "bert")
except Exception as error:
    status = getattr(getattr(error, "response", None), "status_code", None)
    print("Download error:", type(error).__name__, "HTTP:", status)

放大查看操作位置

1. 先确认访问条件 — 本练习使用保存的 Token 验证带授权的下载。公开资源也可能允许匿名访问；私有或受限资源除了有效 Token，还需要账号具有相应权限。

2. 先下载小型配置文件 — 先下载配置文件，不要一开始就下载完整权重。在笔记本单元中运行示例。

3. 找到缓存和下载文件 — 默认 Hugging Face 缓存位于 Models 目录。自定义 HF_HOME 环境变量可以改变这个位置。

4. 加载权重前检查兼容性 — 下载成功不代表模型一定能运行。还需要检查依赖包、模型格式、可用内存和设备后端。

核对结果

Configuration downloaded: True 表示小型配置文件已下载且能正确解析，不代表模型推理或其他模型的访问权限已验证。

如果没有成功

新保存的 Token 或环境变量未生效时，重启内核。
遇到 401/403 时，检查 Token 和资源的账号访问权限。
下载成功但不能加载时，检查格式、所需依赖和可用内存。

下一步

联系支持