在PyTorch中实现.pt模型文件与.bin二进制格式的高效转换

 更新时间:2026年03月27日 09:34:54   作者:Asia-Lee  
文章介绍了.pt和.bin两种模型保存格式的区别,包括格式规范、用途、兼容性等,并提供了转换方法和典型应用场景,特别强调了在不同场景下选择合适格式的重要性,以及注意事项和示例,如HuggingFace模型的转换,需要的朋友可以参考下
  • 在深度学习中,.pt(PyTorch模型文件)和.bin(通用二进制文件)是两种常见的模型保存格式,它们的区别主要体现在 格式规范、用途和兼容性 上。

1. 格式区别

特性.pt(PyTorch格式).bin(通用二进制格式)
开发者/框架PyTorch 专用通用格式,无框架限制
存储内容可保存完整的模型(参数+架构+优化器状态+其他元数据)通常仅保存模型权重(参数)
文件大小较大(包含额外信息)较小(仅参数)
加载方式需用 torch.load() 和对应模型类需手动加载到匹配的模型结构中
兼容性依赖 PyTorch 版本跨框架兼容(如 ONNX、TensorFlow)
典型用途PyTorch 训练/推理跨平台部署、参数共享

2. 转换方法

2.1 .pt → .bin(提取权重)

  • 若只需保存模型参数(权重),可通过以下代码转换:
import torch
# 加载原始 .pt 文件(假设为模型权重)
model = torch.load("model.pt")  # 可能是完整的模型或仅参数
# 提取权重字典(若保存的是完整模型,需 model.state_dict())
if isinstance(model, torch.nn.Module):
    state_dict = model.state_dict()
else:
    state_dict = model
# 保存为 .bin 文件
torch.save(state_dict, "model.bin")

2.2 .bin → .pt(重建完整模型)

  • 需要预先定义模型结构,再加载参数:
import torch
from model_definition import MyModel  # 导入模型定义
# 初始化模型
model = MyModel()
# 加载 .bin 文件中的参数
state_dict = torch.load("model.bin")
model.load_state_dict(state_dict)
# 保存为完整 .pt 文件(可选)
torch.save(model, "full_model.pt")

3. 典型场景

3.1 跨框架部署

  • 步骤
    1. 将 PyTorch 的 .pt 转换为仅权重的 .bin
    2. 在目标框架(如 TensorFlow)中加载 .bin 并重建模型。
  • 工具
    使用 onnxruntimetf-models-official 实现跨框架兼容。

3.2 参数共享

  • 需求
    仅共享模型权重,避免暴露模型架构细节。
  • 示例
    Hugging Face Transformers 库的预训练模型通常以 .bin 发布(如 pytorch_model.bin)。

3.3 轻量化部署

  • 优势
    .bin 文件更小,适合嵌入式设备或移动端(需配合轻量级推理引擎如 TFLite)。

4. 注意事项

  1. 模型架构一致性
    • .bin 文件不包含模型结构,加载时需确保目标模型与参数完全匹配。
    • 若参数名称或形状不匹配,会导致加载失败(如 Missing key(s) in state_dict)。
  2. 版本兼容性
    • PyTorch 的 .pt 文件可能因版本不同导致兼容性问题,而 .bin 作为纯权重文件更易跨版本使用。
  3. 安全性
    • .pt 文件可能包含恶意代码(因其可序列化任意对象),加载来源不明的文件需谨慎。
    • .bin 仅参数,安全性相对更高。

5. 示例:Hugging Face 模型转换

Hugging Face 模型通常提供两种格式:

  • PyTorch 格式pytorch_model.pt.bin
  • TensorFlow 格式tf_model.h5

转换代码

from transformers import AutoModel
# 加载 PyTorch 模型
model = AutoModel.from_pretrained("bert-base-uncased")
# 保存为 .bin 文件(仅权重)
model.save_pretrained("save_dir", save_format="pt")  # 生成 pytorch_model.bin

6. 总结

  • .pt.bin:适用于 提取权重、跨框架部署,需保证模型结构一致性。
  • .bin.pt:需提前定义模型类,适合 PyTorch 生态内的完整模型重建

以上就是在PyTorch中实现.pt模型文件与.bin二进制格式的高效转换的详细内容,更多关于PyTorch实现.pt与.bin的转换的资料请关注脚本之家其它相关文章!

相关文章

  • python3 flask 文件占用未释放问题

    python3 flask 文件占用未释放问题

    这篇文章主要介绍了python3 flask 文件占用未释放问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-11-11
  • 对pandas里的loc并列条件索引的实例讲解

    对pandas里的loc并列条件索引的实例讲解

    今天小编就为大家分享一篇对pandas里的loc并列条件索引的实例讲解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-11-11
  • Python获取指定日期是"星期几"的6种方法

    Python获取指定日期是"星期几"的6种方法

    在Python进行数据分析时,按照日期进行分组汇总也是被需要的,比如会找到销量的周期性规律。本文将以2022-02-22为例,演示Python获取指定日期是“星期几”的6种方法,需要的可以参考一下
    2022-03-03
  • 使用pycharm和pylint检查python代码规范操作

    使用pycharm和pylint检查python代码规范操作

    这篇文章主要介绍了使用pycharm和pylint检查python代码规范操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-06-06
  • Python Pandas pandas.read_sql函数实例用法

    Python Pandas pandas.read_sql函数实例用法

    在本篇文章里小编给大家整理的是一篇关于Python Pandas pandas.read_sql函数详解内容,有需要的朋友们可以学习下。
    2021-06-06
  • 浅谈Python类的__getitem__和__setitem__特殊方法

    浅谈Python类的__getitem__和__setitem__特殊方法

    下面小编就为大家带来一篇浅谈Python类的__getitem__和__setitem__特殊方法。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-12-12
  • 浅谈python 类方法/静态方法

    浅谈python 类方法/静态方法

    这篇文章主要介绍了python 类方法/静态方法的相关资料,帮助大家更好的理解和学习python,感兴趣的朋友可以了解下
    2020-09-09
  • 使用Numpy打乱数组或打乱矩阵行

    使用Numpy打乱数组或打乱矩阵行

    这篇文章主要介绍了使用Numpy打乱数组或打乱矩阵行问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-05-05
  • Python 单元测试(unittest)的使用小结

    Python 单元测试(unittest)的使用小结

    Python中有一个自带的单元测试框架是unittest模块,用它来做单元测试,本篇文章主要介绍了Python 单元测试(unittest)的使用小结,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-11-11
  • Python模拟百度自动输入搜索功能的实例

    Python模拟百度自动输入搜索功能的实例

    今天小编就为大家分享一篇Python模拟百度自动输入搜索功能的实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-02-02

最新评论