PyInstaller打包Exe后customtkinter的CTkEntry textvariable失效问题

问题分析 #

VS Code运行脚本时一切正常，但PyInstaller打包为exe后，二级窗口中CTkEntry的textvariable无法正确赋值，主窗口无此问题。核心原因是打包后Python的垃圾回收机制可能提前回收了二级窗口的StringVar变量，导致绑定关系断裂；或是CustomTkinter的资源未被完整打包。

可行解决方案 #

• 直接从CTkEntry实例取值，绕过textvariable
  放弃使用textvariable，直接保存CTkEntry的引用，在需要取值时调用get()方法，这种方式最稳定，能避免变量绑定的GC问题：

  # 初始化二级窗口时保存entry引用
  self.entryWidget = customtkinter.CTkEntry(master=self.window)
  self.entryWidget.pack()
  customtkinter.CTkButton(master=self.window, text="Done", command=self.dismissWindow).pack()
  
  # 在回调方法中直接取值
  def dismissWindow(self):
      input_content = self.entryWidget.get()
      # 后续处理input_content的逻辑
  

• 强制保留StringVar引用，防止被GC回收
  如果一定要用textvariable，可以在二级窗口类中额外维护一个列表，专门存放这些变量，确保它们不会被垃圾回收器清理：

  # 初始化时创建变量存储列表
  self._persistent_vars = []
  self.entryString = tkinter.StringVar()
  # 将变量加入列表，强制保留引用
  self._persistent_vars.append(self.entryString)
  
  entryWidget = customtkinter.CTkEntry(master=self.window, textvariable=self.entryString)
  entryWidget.pack()
  customtkinter.CTkButton(master=self.window, text="Done", command=self.dismissWindow).pack()
  

• 使用CustomTkinter自带的StringVar
  CustomTkinter提供了自己的变量类，相比原生tkinter的变量，和CTk组件的兼容性更好，打包后更稳定：

  # 注意导入customtkinter的StringVar
  self.entryString = customtkinter.StringVar()
  entryWidget = customtkinter.CTkEntry(master=self.window, textvariable=self.entryString)
  entryWidget.pack()
  customtkinter.CTkButton(master=self.window, text="Done", command=self.dismissWindow).pack()
  

• 调整PyInstaller打包参数
  确保CustomTkinter的所有资源被完整打包，在auto-py-to-exe的「Additional Arguments」中添加：

  --collect-all customtkinter --hiddenimport win32timezone
  

  替换原来仅指定库文件夹的配置，--collect-all会自动收集customtkinter的所有依赖资源，避免打包不完整导致的组件异常。

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