Python打包时包含字库文件的几种常见方法

 更新时间:2025年05月12日 11:22:10   作者:恋恋西风  
这篇文章主要给大家介绍了关于Python打包时包含字库文件的几种常见方法,通过示例讲解了基本方法、使用spec文件、批量添加字体文件夹和在代码中访问字体文件的注意事项,需要的朋友可以参考下

前言

在 Python 打包时,如果你想将字库文件(如 .ttf、.otf 等字体文件)一起打包成一个可执行文件,有几种常见的方法,具体取决于你使用的打包工具。

使用 PyInstaller

PyInstaller 是最常用的打包工具之一,以下是包含字库文件的方法:

1. 基本方法 - 使用 --add-data 参数:

pyinstaller --onefile --add-data="font.ttf;." your_script.py

多个:

pyinstaller --onefile --add-data="font1.ttf:." --add-data="font2.ttf:." --add-data="fonts/font3.otf:fonts/" your_script.py

2. 使用 spec 文件(更推荐的方法):

  • 首先生成 spec 文件:pyi-makespec your_script.py

  • 然后修改 spec 文件,在 a.datas 中添加字体文件:

a = Analysis(
    ['your_script.py'],
    binaries=[],
    datas=[('font.ttf', '.')],  # 添加这行
    ...
)

添加多个文件

a = Analysis(
    ['your_script.py'],
    binaries=[],
    datas=[
        ('font1.ttf', '.'),
        ('font2.ttf', '.'),
        ('fonts/font3.otf', 'fonts'),  # 保持目录结构
        ('fonts/font4.ttf', 'fonts'),
    ],
    ...
)

需要在代码中处理字体路径:

import os
import sys

def resource_path(relative_path):
    """ 获取资源的绝对路径 """
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    return os.path.join(os.path.abspath("."), relative_path)

# 使用示例
font_path = resource_path("font.ttf")

注意事项

  • 确保在代码中正确引用字体文件路径(使用上述的 resource_path 方法)

  • 字体文件较大的话,打包后的文件体积会显著增加

  • 测试打包后的程序是否能正确加载字体

  • 考虑字体文件的许可证问题,确保你有权分发该字体

选择哪种方法取决于你的具体需求和使用的打包工具。PyInstaller 通常是跨平台打包的最佳选择。

3. 批量添加字体文件夹

import glob

# 获取所有字体文件
font_files = glob.glob('fonts/*.ttf') + glob.glob('fonts/*.otf')

a = Analysis(
    ['your_script.py'],
    binaries=[],
    datas=[(font, 'fonts') for font in font_files],
    ...
)

注意事项

  • 保持文件目录结构一致,特别是在代码中引用字体时

  • 检查字体文件的许可证,确保可以合法分发

  • 大量字体文件会显著增加打包后的体积

  • 测试打包后的程序能否正确找到并加载所有字体

  • 考虑使用相对路径而不是绝对路径引用字体文件

选择哪种方法取决于你的项目需求和使用的打包工具。对于大多数情况,PyInstaller 的 spec 文件方式提供了最好的灵活性和可维护性。

4. 使用 spec 文件打包

pyinstaller your_script.spec

5.在代码中访问打包后的字体文件

import os
import sys
from pathlib import Path

def resource_path(relative_path):
    """ 获取打包后资源的绝对路径 """
    if hasattr(sys, '_MEIPASS'):
        base_path = Path(sys._MEIPASS)
    else:
        base_path = Path.cwd()
    return str(base_path / relative_path)

# 使用示例
font_path = resource_path('fonts/NotoSans-Regular.ttf')

# 使用字体(以Pillow为例)
from PIL import ImageFont
try:
    font = ImageFont.truetype(font_path, size=12)
except IOError:
    print(f"无法加载字体文件: {font_path}")
    font = ImageFont.load_default()

总结 

到此这篇关于Python打包时包含字库文件的几种常见方法的文章就介绍到这了,更多相关Python打包包含字库文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • python使用自定义user-agent抓取网页的方法

    python使用自定义user-agent抓取网页的方法

    这篇文章主要介绍了python使用自定义user-agent抓取网页的方法,涉及Python使用urllib2模块操作网页的技巧,需要的朋友可以参考下
    2015-04-04
  • 使用Python制作一个数据预处理小工具(多种操作一键完成)

    使用Python制作一个数据预处理小工具(多种操作一键完成)

    这篇文章主要介绍了使用Python制作一个数据预处理小工具(多种操作一键完成),本文通过图文实例相结合给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-02-02
  • Python之urlencode和urldecode案例讲解

    Python之urlencode和urldecode案例讲解

    这篇文章主要介绍了Python之urlencode和urldecode案例讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
    2021-08-08
  • python中实现将多个print输出合成一个数组

    python中实现将多个print输出合成一个数组

    下面小编就为大家分享一篇python中实现将多个print输出合成一个数组,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-04-04
  • Python求出0~100以内的所有素数

    Python求出0~100以内的所有素数

    质数又称素数。一个大于1的自然数,除了1和它自身外,不能被其他自然数整除的数叫做质数;否则称为合数。下面小编给大家带来了Python求出0~100以内的所有素数实例代码,需要的朋友参考下
    2018-01-01
  • Python中dilb和face_recognition第三方包安装失败的解决

    Python中dilb和face_recognition第三方包安装失败的解决

    本文主要介绍了Python中dilb和face_recognition第三方包安装失败的解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-02-02
  • Python Tornado批量上传图片并显示功能

    Python Tornado批量上传图片并显示功能

    Tornado龙卷风是一个开源的网络服务器框架,它是基于社交聚合网站FriendFeed的实时信息服务开发而来的。这篇文章主要介绍了Python Tornado批量上传图片并显示,需要的朋友可以参考下
    2020-03-03
  • pyinstaller打包python3.6和PyQt5中各种错误的解决方案汇总

    pyinstaller打包python3.6和PyQt5中各种错误的解决方案汇总

    pyinstaller是打包python很方便的一个套件,我们可以很轻易地使用他,下面这篇文章主要给大家介绍了关于pyinstaller打包python3.6和PyQt5中各种错误解决的相关资料,需要的朋友可以参考下
    2022-08-08
  • Python数据结构之栈、队列的实现代码分享

    Python数据结构之栈、队列的实现代码分享

    这篇文章主要介绍了Python数据结构之栈、队列的实现代码分享,具有一定参考价值,需要的朋友可以了解下。
    2017-12-12
  • 利用python将pdf输出为txt的实例讲解

    利用python将pdf输出为txt的实例讲解

    下面小编就为大家分享一篇利用python将pdf输出为txt的实例讲解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-04-04

最新评论