2026/4/18 12:48:59
网站建设
项目流程
集团高端网站建设公司,crm管理系统的优缺点,linux下做网站,建设工程人员押证在哪个网站查在使用 huggingface-cli download 时#xff0c;断点续传的核心是 --resume-download 参数#xff0c;该参数能检测本地未完成的下载文件#xff0c;从断点处继续传输#xff08;而非重新下载#xff09;。以下是完整的使用方法、生效条件和问题排查#xff1a;
一、核心…在使用huggingface-cli download时断点续传的核心是--resume-download参数该参数能检测本地未完成的下载文件从断点处继续传输而非重新下载。以下是完整的使用方法、生效条件和问题排查一、核心原理--resume-download会在下载时生成临时文件后缀通常为.tmp记录已下载的字节数当下载中断网络断开、进程终止等重新执行带该参数的命令时工具会读取临时文件从断点处续传避免重复下载已完成部分。二、前提准备确保huggingface-hub版本足够新v0.10 支持该参数v0.16 对大文件/LFS 文件支持更完善pipinstall--upgrade huggingface-hub三、断点续传的具体用法1. 基础用法以下载 LiveCodeBench 为例在原有下载命令后直接添加--resume-download即可huggingface-cli download LiveCodeBench/LiveCodeBench\--local-dir LiveCodeBench\# 本地保存目录--local-dir-use-symlinks False\# 强制下载文件非符号链接--resume-download# 核心断点续传参数2. 结合筛选规则include/exclude若仅下载指定文件/排除部分文件续传参数仍兼容huggingface-cli download LiveCodeBench/LiveCodeBench\--includedata/**,evaluation/*.py\# 只下载指定目录/文件--excludedocs/**\# 排除无需下载的内容--local-dir LiveCodeBench\--local-dir-use-symlinks False\--resume-download3. 下载指定版本 断点续传若需下载特定分支/commit/tag续传参数同样生效huggingface-cli download LiveCodeBench/LiveCodeBench\--revision v1.0\# 指定版本分支/标签/commit hash--local-dir LiveCodeBench\--local-dir-use-symlinks False\--resume-download4. 自动重试 断点续传网络不稳定时搭配--retries NN 为重试次数实现中断后自动重试 续传huggingface-cli download LiveCodeBench/LiveCodeBench\--local-dir LiveCodeBench\--local-dir-use-symlinks False\--resume-download\--retries5# 最多自动重试5次四、断点续传生效条件本地保留了中断后的临时文件--local-dir目录下会生成.tmp后缀的临时文件不要删除/移动重新执行的命令与中断前完全一致包括--local-dir、--include/--exclude、--revision等所有参数否则会视为新下载目标文件在 Hugging Face Hub 上未被修改若文件更新工具会判定为新文件重新下载。五、常见问题排查1. 断点续传未生效重新从头下载原因1huggingface-hub版本过旧 → 执行pip install --upgrade huggingface-hub升级原因2临时文件被删除 → 中断后不要清理--local-dir目录保留.tmp文件原因3命令参数不一致 → 确保重新执行的命令和中断前的参数完全相同比如--local-dir路径不能改原因4文件在 Hub 上已更新 → 可删除本地旧文件后重新下载。2. 报错 “Resume download not supported for this file”原因旧版本对 LFS 大文件的断点续传支持不足 → 升级到huggingface-hub0.16.0即可解决。3. 续传时提示文件校验失败原因中断导致临时文件损坏 → 删除该文件的.tmp临时文件重新执行命令会从头下载该文件但其他文件仍可续传。六、补充说明--resume-download是幂等的即使文件已完全下载执行带该参数的命令也不会重复下载只会校验文件完整性若需强制重新下载忽略断点移除--resume-download参数或删除--local-dir目录后重新执行。参考livecodebench/code_generation_lite