在 customtkinter 项目中，若为多个界面分别创建独立的 `ctk` 主窗口（如 `ctk()` 实例），会导致 tkinter 图像资源管理冲突，引发 `tclerror: image "pyimagex" doesn't exist` 错误；根本解法是仅保留一个主 tk 环境（`ctk`），其余界面统一使用 `ctktoplevel`。
CustomTkinter 基于 Tkinter 构建，而 Tkinter 的图像对象（如 PhotoImage 或 CTkImage 所封装的底层资源）严格绑定于单一 Tk 根窗口（Tk 实例）。当你定义两个类均继承自 customtkinter.CTk（即各自创建一个独立的 Tk 实例），就等于启动了两个互不共享图像上下文的 Tk 环境。此时，虽然 images.py 中的 CTkImage 对象在 Python 层被成功创建，但它所关联的底层 Tk photo image 只注册在第一个 CTk 实例的 Tcl 解释器中；当第二个 CTk 实例（如 Welcomepage）尝试渲染该图像时，Tcl 引擎无法找到对应 ID（例如 "pyimage11"），从而抛出经典错误：_tkinter.TclError: image "pyimage11" doesn't exist。
✅ 正确架构原则：
- 全局唯一主窗口（CTk）：作为整个应用的根容器，负责托管所有 CTkToplevel 子窗口，并统一管理图像、主题、事件循环等核心资源；
- 子界面使用 CTkToplevel：所有非主入口的 UI（如欢迎页、设置弹窗、详情面板）应继承 customtkinter.CTkToplevel，并显式传入父窗口引用（如 self），确保图像资源在同一线程、同一 Tk 上下文中解析与渲染。
以下是修正后的 Application.py 完整实现（已适配最新 CustomTkinter v5+ API）：
import images.image as images
import customtkinter
class UserInterface(customtkinter.CTkToplevel):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.geometry("600x600")
self.title("YBlocker - Main Interface")
# 左侧菜单栏
self.menu = customtkinter.CTkFrame(self, width=150, height=600,
border_width=1, border_color="#1F538D")
self.menu.place(x=0, y=0)
# 菜单栏 Logo（复用 images.logo_ui）
self.logo_label = customtkinter.CTkLabel(
self.menu,
image=images.logo_ui,
text=""
)
self.logo_label.place(x=11, y=10)
class Welcomepage(customtkinter.CTk):
def __init__(self):
super().__init__()
self.geometry("384x308")
self.title("YBlocker - Welcome")
self.resizable(False, False)
# 欢迎页 Logo（复用 images.logo_welcome）
self.image_label = customtkinter.CTkLabel(
self,
image=images.logo_welcome,
text="",
width=128,
height=128
)
self.image_label.place(x=128, y=20)
# IP 输入框与启动按钮
self.ip_entry = customtkinter.CTkEntry(self, placeholder_text="Database IP Address", width=200)
self.ip_entry.place(x=92, y=150)
self.start_button = customtkinter.CTkButton(
self,
text="Start",
width=100,
command=self.start_button_action
)
self.start_button.place(x=142, y=230)
# 缓存对子窗口的引用，防止被垃圾回收
self.toplevel_window = None
def start_button_action(self):
# 关闭欢迎页（可选：调用 self.destroy()）
# self.destroy()
# 创建主界面，以当前窗口为父级
self.toplevel_window = UserInterface(self)
# 可选：置顶主界面
self.toplevel_window.after(100, self.toplevel_window.lift)
# ✅ 全局仅启动一个 CTk 实例 —— 欢迎页即为主窗口
if __name__ == "__main__":
app = Welcomepage()
app.mainloop()? 关键注意事项与最佳实践：
-
路径兼容性：images.py 中的 Image.open("images\yblocker.png") 使用反斜杠 \ 在 Windows 外平台可能报错。推荐统一改用正斜杠 / 或 pathlib.Path：
from pathlib import Path img_path = Path("images") / "yblocker.png" logo_ui = customtkinter.CTkImage( light_image=Image.open(img_path), dark_image=Image.open(img_path), size=(128, 128) ) - 图像生命周期管理：CTkImage 实例需在窗口生命周期内持续存在（Python 层强引用）。避免在方法内临时创建后丢弃（如 lambda: CTkImage(...)），否则 GC 回收将导致图像失效。
- Toplevel 窗口行为控制：可通过 self.toplevel_window.transient(self) 设置模态关系，或 self.toplevel_window.protocol("WM_DELETE_WINDOW", ...) 自定义关闭逻辑。
- 调试技巧：若仍遇图像异常，可在 CTkLabel 初始化后添加 print(self._image) 验证是否成功绑定；或启用 customtkinter.set_debug(True) 查看内部日志。
总结而言，该问题并非 CustomTkinter 的 Bug，而是对 Tkinter 底层图像资源模型的理解偏差所致。坚持「单 CTk + 多 CTkToplevel」的设计范式，不仅能彻底规避图像加载异常，还能提升应用稳定性、内存效率与跨平台兼容性。
