Python tkinter运行报错unknown option "-font"如何解决

核心错误原因 #

该报错和系统、VSCode环境、字体本身均无关系，是参数传递位置错误导致：

• font是Label、Entry等Tkinter控件本身的配置参数，不属于place()/pack()/grid()这三个布局方法的支持参数
• 现有代码先创建了无样式的控件实例，再把font参数传入了.place()调用链中，Tkinter解析布局方法参数时无法识别-font选项，直接抛出错误

修复方法 #

将font参数从.place()方法中移出，放到控件初始化语句中，或通过控件的.config()方法单独设置。

错误写法 #

text1 = tk.Label(rt, text="Hello World")
# 错误：font属于控件参数，不属于place布局参数
text1.place(in_=f1, width=210, height=33, relx=0.5,rely=0.50, anchor=tk.CENTER, font=("Arial", 25))
e1 = tk.Entry(bd=1)
e1.place(in_=f1, width=210, height=33, relx=0.5,
         rely=0.55, anchor=tk.CENTER, font=("Arial", 25))

正确写法1：初始化时传入字体参数 #

def openMAINMENUPASSWORD():
    rt = Window.root
    # 字体参数在控件初始化时传入
    text1 = tk.Label(rt, text="Hello World", font=("Arial", 25))
    text1.place(in_=f1, width=210, height=33, relx=0.5,rely=0.50, anchor=tk.CENTER)
    e1 = tk.Entry(bd=1, font=("Arial", 25))
    e1.place(in_=f1, width=210, height=33, relx=0.5,
             rely=0.55, anchor=tk.CENTER)

    rt.mainloop()

正确写法2：通过config方法事后配置字体 #

def openMAINMENUPASSWORD():
    rt = Window.root
    text1 = tk.Label(rt, text="Hello World")
    # 单独调用config设置字体
    text1.config(font=("Arial", 25))
    text1.place(in_=f1, width=210, height=33, relx=0.5,rely=0.50, anchor=tk.CENTER)
    e1 = tk.Entry(bd=1)
    e1.config(font=("Arial", 25))
    e1.place(in_=f1, width=210, height=33, relx=0.5,
             rely=0.55, anchor=tk.CENTER)

    rt.mainloop()

补充排查项（修正参数位置后仍报错时检查） #

• 验证Tkinter环境完整性：终端执行python3 -m tkinter，若正常弹出Tkinter测试窗口则环境无异常
• 若提示字体不存在，可将Arial替换为macOS自带字体，例如"Helvetica"、"PingFang SC"测试，注意字体不存在的报错提示会明确指向字体加载失败，不会出现unknown option "-font"的提示
• 所有控件样式类参数（前景色、背景色、字体、对齐方式等）均不能传入布局方法，必须在控件初始化或.config()调用时设置

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