在uv环境运行Tkinter应用为何出现字体异常？

可能原因 #

CachyOS下uv环境未正确继承系统Tkinter/ttk的字体渲染依赖，或系统缺少ttk所需的基础字体库。

修复方案 #

1. 安装系统级字体与Tk依赖 #

CachyOS基于Arch Linux，执行以下命令确保完整安装Tkinter相关依赖及通用字体：

sudo pacman -S tk ttf-dejavu noto-fonts libxft

安装完成后重新用uv run main.py测试。

2. 让uv继承系统站点包 #

uv默认会创建隔离的虚拟环境，可能未包含系统级的Tkinter依赖。可以通过以下两种方式解决：

• 临时运行时启用系统站点包：

  uv run --system-site-packages main.py
  

• 永久为当前项目配置：在项目根目录创建pyproject.toml，添加以下内容：

  [tool.uv]
  system-site-packages = true
  

  之后直接用uv run main.py即可。

3. 强制指定ttk组件字体 #

在代码中手动指定字体，绕过环境默认字体检测问题：

import tkinter as tk
from tkinter import ttk

def main() -> None:
    root = tk.Tk()
    root.title('Hello world')
    # 手动指定字体，使用系统已安装的字体（比如DejaVu Sans）
    label = ttk.Label(root, text='Hola Mundo', font=('DejaVu Sans', 12))
    label.grid(row=0, column=0, sticky=tk.E, padx=5, pady=5)
    root.geometry('400x400')
    root.mainloop()

if __name__ == '__main__':
    main()

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