快捷導(dǎo)航

Python將字庫(kù)文件打包成可執(zhí)行文件的常見(jiàn)方法

更新時(shí)間：2025年05月12日 11:02:53 作者：戀戀西風(fēng)

在 Python 打包時(shí),如果你想將字庫(kù)文件一起打包成一個(gè)可執(zhí)行文件,有幾種常見(jiàn)的方法,具體取決于你使用的打包工具,下面就跟隨小編一起了解下具體的實(shí)現(xiàn)方法吧

使用 PyInstaller

PyInstaller 是最常用的打包工具之一，以下是包含字庫(kù)文件的方法：

基本方法 - 使用 --add-data 參數(shù)

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

多個(gè)：

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

使用 spec 文件（更推薦的方法）

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

然后修改 spec 文件，在 a.datas 中添加字體文件：

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

添加多個(gè)文件

a = Analysis(
    ['your_script.py'],
    binaries=[],
    datas=[
        ('font1.ttf', '.'),
        ('font2.ttf', '.'),
        ('fonts/font3.otf', 'fonts'),  # 保持目錄結(jié)構(gòu)
        ('fonts/font4.ttf', 'fonts'),
    ],
    ...
)

需要在代碼中處理字體路徑：

import os
import sys
 
def resource_path(relative_path):
    """ 獲取資源的絕對(duì)路徑 """
    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")

注意事項(xiàng)

確保在代碼中正確引用字體文件路徑（使用上述的 resource_path 方法）

字體文件較大的話，打包后的文件體積會(huì)顯著增加

測(cè)試打包后的程序是否能正確加載字體

考慮字體文件的許可證問(wèn)題，確保你有權(quán)分發(fā)該字體

選擇哪種方法取決于你的具體需求和使用的打包工具。PyInstaller 通常是跨平臺(tái)打包的最佳選擇。

批量添加字體文件夾

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],
    ...
)

注意事項(xiàng)

保持文件目錄結(jié)構(gòu)一致，特別是在代碼中引用字體時(shí)
檢查字體文件的許可證，確保可以合法分發(fā)
大量字體文件會(huì)顯著增加打包后的體積
測(cè)試打包后的程序能否正確找到并加載所有字體
考慮使用相對(duì)路徑而不是絕對(duì)路徑引用字體文件

選擇哪種方法取決于你的項(xiàng)目需求和使用的打包工具。對(duì)于大多數(shù)情況，PyInstaller 的 spec 文件方式提供了最好的靈活性和可維護(hù)性。

使用 spec 文件打包

pyinstaller your_script.spec

在代碼中訪問(wèn)打包后的字體文件

import os
import sys
from pathlib import Path
 
def resource_path(relative_path):
    """ 獲取打包后資源的絕對(duì)路徑 """
    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"無(wú)法加載字體文件: {font_path}")
    font = ImageFont.load_default()

到此這篇關(guān)于Python將字庫(kù)文件打包成可執(zhí)行文件的常見(jiàn)方法的文章就介紹到這了,更多相關(guān)Python打包字庫(kù)文件內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: