ttkbootstrap 是对 tkinter 的替换而非美化，需全程使用其组件和 Window 类，禁用原生 tk 组件；主题分全局（themename）与组件级（bootstyle）；容器须统一用 tb.Frame 等；高 DPI 需显式声明感知。
ttkbootstrap 和原生 tkinter 的关系不是“美化”，而是“替换”
ttkbootstrap 不是给 tk.Button 或 tk.Label 加个皮肤的工具，它提供的是基于 ttk 的全新组件集（如 tb.Button、tb.Label），底层仍走 ttk 渲染管线，但默认加载了 Bootstrap 风格的主题和样式。直接混用 tk 和 tb 组件会导致布局错乱、主题不一致、甚至 AttributeError（比如 tk.Button 没有 bootstyle 参数）。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 彻底弃用
import tkinter as tk中的tk.Button、tk.Frame等，改用ttkbootstrap对应的类，例如from ttkbootstrap import Button, Frame, Label - 初始化窗口必须用
ttkbootstrap.Window()，不能用tk.Tk()—— 否则主题、图标、DPI 适配全失效 -
ttkbootstrap的Style是单例，全局生效，不要重复实例化
如何正确设置主题和颜色风格（bootstyle）
主题控制分两层：全局主题（light/dark）决定整体明暗，bootstyle 控制单个组件的语义颜色（primary、success、danger 等）。两者不冲突，但容易误以为设了 bootstyle="dark" 就能切暗色模式——其实 "dark" 是一个按钮风格，不是全局主题。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 全局主题在创建窗口时指定：
Window(themename="cosmo")（可用值见ttkbootstrap.themes.THEME_NAMES） - 组件级颜色用
bootstyle，例如Button(bootstyle="primary-outline")，支持连写（"success-round"）、多值（"warning, toolbutton"） - 修改运行时主题：调用窗口对象的
style.theme_use("yeti")，然后手动刷新（update_idletasks()），否则部分组件可能不重绘
常见布局错乱：为什么 pack()/grid() 失效或组件不显示？
根本原因通常是父容器类型不匹配。ttkbootstrap 的 Frame、Labelframe 默认启用了 ttk 的 padding 和 border 样式，而原生 tk.Frame 没有；若把 tb.Button 放进 tk.Frame，padding 计算异常，导致 pack(fill="x") 不撑满，或 grid() 单元格留白过大。
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 所有容器一律用
ttkbootstrap.Frame、ttkbootstrap.Labelframe，避免嵌套tk.Frame - 启用
autohide=True的Scrollbar在grid()中需搭配sticky和weight配置，否则滚动条常“消失” - 使用
ttkbootstrap.ScrolledFrame替代手拼Canvas + Scrollbar，它内部已处理好grid的行列权重与绑定
字体、缩放与高 DPI 下的显示异常
Windows/macOS 高 DPI 屏幕下，ttkbootstrap 默认会尝试自动缩放，但若程序未声明 DPI 感知（尤其打包成 exe 后），会出现文字模糊、按钮过小、图标拉伸等问题。这不是 ttkbootstrap 的 bug，而是 Tk/ttk 的底层限制。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 开发期在脚本开头加：
import ctypes; ctypes.windll.shcore.SetProcessDpiAwareness(1)（仅 Windows） - 避免硬编码字体大小，改用相对单位：
font=("Helvetica", -12)中的负值表示“逻辑像素”，由系统换算 - 打包时（PyInstaller）需额外参数：
--add-data "ttkbootstrap;ttkbootstrap"确保主题资源被包含，否则运行时报ThemeNotFound
最易被忽略的一点：ttkbootstrap 的 bootstyle 不是 CSS 类名，无法通过字符串拼接动态生成（如 f"{var}-outline"）再传入——必须确保字符串字面量合法，否则静默降级为默认样式，很难排查。
