使用CustomTkinter导入Armin Grotesk字体跨设备失效问题求助

方案一：随项目嵌入字体文件（无需系统安装） #

这是最稳妥的跨设备解决方案，字体随项目文件同步转移，无需修改用户系统设置，直接在代码中加载使用。

操作步骤 #

1. 将Armin Grotesk字体文件（如ArminGrotesk-Regular.ttf）放到项目目录下的专属子文件夹，比如./fonts/
2. 通过tkinter.font模块注册自定义字体，再在CustomTkinter组件中指定使用

代码示例 #

import tkinter
import tkinter.font
import customtkinter

# 注册自定义字体
armin_font = tkinter.font.Font(
    family="Armin Grotesk",
    fname="./fonts/ArminGrotesk-Regular.ttf",  # 字体文件相对路径
    size=14
)

# 初始化CustomTkinter环境
customtkinter.set_appearance_mode("light")
customtkinter.set_default_color_theme("blue")

app = customtkinter.CTk()
app.geometry("400x200")

# 应用自定义字体创建组件
test_label = customtkinter.CTkLabel(app, text="Armin Grotesk字体测试", font=armin_font)
test_label.pack(pady=30)

app.mainloop()

打包注意事项 #

如果用PyInstaller等工具打包项目，需在打包配置中添加字体文件夹作为资源（比如在.spec文件中通过datas参数指定('./fonts', 'fonts')）。

方案二：后台静默安装字体到系统 #

若需要让字体在用户系统全局可用，可通过代码实现跨平台静默安装，以下是分系统的实现方式：

Windows系统 #

依赖pywin32库，先执行pip install pywin32安装依赖：

import os
import shutil
import win32api
import win32con

FONT_SOURCE = "./fonts/ArminGrotesk-Regular.ttf"
SYSTEM_FONT_DIR = os.path.join(os.environ["WINDIR"], "Fonts")

# 复制字体到系统字体目录
shutil.copy(FONT_SOURCE, SYSTEM_FONT_DIR)
# 刷新系统字体缓存
win32api.SHChangeNotify(win32con.SHCNE_ASSOCCHANGED, win32con.SHCNF_IDLIST, None, None)

macOS系统 #

直接复制字体到用户字体目录，系统会自动识别：

import os
import shutil

FONT_SOURCE = "./fonts/ArminGrotesk-Regular.ttf"
USER_FONT_DIR = os.path.expanduser("~/Library/Fonts/")

os.makedirs(USER_FONT_DIR, exist_ok=True)
shutil.copy(FONT_SOURCE, USER_FONT_DIR)

Linux系统 #

复制字体到用户字体目录后刷新字体缓存：

import os
import shutil
import subprocess

FONT_SOURCE = "./fonts/ArminGrotesk-Regular.ttf"
USER_FONT_DIR = os.path.expanduser("~/.fonts/")

os.makedirs(USER_FONT_DIR, exist_ok=True)
shutil.copy(FONT_SOURCE, USER_FONT_DIR)
# 刷新字体缓存
subprocess.run(["fc-cache", "-fv"], check=True)

跨平台整合代码 #

import os
import shutil
import platform
import subprocess

def install_font(font_path):
    system = platform.system()
    font_filename = os.path.basename(font_path)
    
    if system == "Windows":
        system_font_dir = os.path.join(os.environ["WINDIR"], "Fonts")
        shutil.copy(font_path, system_font_dir)
        import win32api
        import win32con
        win32api.SHChangeNotify(win32con.SHCNE_ASSOCCHANGED, win32con.SHCNF_IDLIST, None, None)
    elif system == "Darwin":
        user_font_dir = os.path.expanduser("~/Library/Fonts/")
        os.makedirs(user_font_dir, exist_ok=True)
        shutil.copy(font_path, user_font_dir)
    elif system == "Linux":
        user_font_dir = os.path.expanduser("~/.fonts/")
        os.makedirs(user_font_dir, exist_ok=True)
        shutil.copy(font_path, user_font_dir)
        subprocess.run(["fc-cache", "-fv"], check=True)

# 调用示例
install_font("./fonts/ArminGrotesk-Regular.ttf")

关键提醒 #

• 字体版权：确认你拥有Armin Grotesk字体的分发/安装授权，商用字体未经授权不得随意传播。
• 权限问题：部分系统（如Windows）安装系统字体可能需要管理员权限，需提前处理权限逻辑。

内容的提问来源于stack exchange，提问作者AshhadDevLab