PyInstaller打包Python Turtle程序为exe后无法显示图形窗口求助

我使用PyInstaller将自己开发的Python Turtle小游戏打包为exe文件，但程序运行时仅会闪一下控制台，Turtle图形窗口无法打开。该游戏支持方向键操作，代码依赖turtle、pygame等库，核心代码如下：

import turtle
import time
import math
import threading
import random
import pygame

pygame.init()
pygame.mixer.init()
pygame.mixer_music.load("Red Sun.mp3")
pygame.mixer_music.play(-1)
pygame.mixer_music.set_volume(.7)

ekran = turtle.Screen()
ekran.setup(800, 700)
ekran.cv._rootwindow.resizable(False, False)
turtle_mozna_ruszac = True
turtle.fillcolor("red")
turtle.pencolor("white")
turtle.shapesize(2)
turtle.shape("square")
enemy = turtle.Turtle()
enemy.shape("circle")

# 省略部分函数定义...

def obroc(deg):
    turtle.speed(11)
    turtle.setheading(deg)
    turtle.speed(4)

def ruch(deg, distance):
    global turtle_mozna_ruszac
    if not turtle_mozna_ruszac:
        return

    new_x = turtle.xcor() + distance * math.cos(math.radians(deg))
    if -300 <= new_x <= 300:
        turtle_mozna_ruszac = False
        obroc(deg)
        turtle.forward(distance)
        print(turtle.pos())
        turtle_mozna_ruszac = True

# 省略按键绑定部分...

turtle.onkey(lewo, 'Left')
turtle.onkey(prawo, 'Right')

turtle.listen()
ekran.mainloop()
turtle.exitonclick()

我尝试过相关解决方案但未解决问题，希望找到可行的解决办法。

解决办法 #

1. 先保留控制台查看错误信息 #

打包时不要使用-w/--windowed参数，这样运行exe时控制台会保留，能直接看到报错内容（比如资源文件找不到、库依赖缺失等）：

pyinstaller your_script.py

运行dist/your_script/your_script.exe，根据控制台的错误提示定位问题。

2. 修复资源文件路径问题 #

打包后pygame加载的Red Sun.mp3路径会失效，需要动态获取资源路径并在打包时将资源纳入：

• 修改代码中加载音频的部分，添加资源路径适配函数：

  import sys
  import os
  
  def resource_path(relative_path):
      try:
          # 打包后PyInstaller生成的临时目录
          base_path = sys._MEIPASS
      except Exception:
          # 开发环境下的当前目录
          base_path = os.path.abspath(".")
      return os.path.join(base_path, relative_path)
  
  # 替换原加载音频的代码
  pygame.mixer_music.load(resource_path("Red Sun.mp3"))
  

• 打包时用--add-data参数将音频文件加入：

  # Windows系统
  pyinstaller --add-data "Red Sun.mp3;." your_script.py
  # Mac/Linux系统
  pyinstaller --add-data "Red Sun.mp3:." your_script.py
  

3. 清理Turtle主循环冲突 #

代码中同时调用了ekran.mainloop()和turtle.exitonclick()，两者都是阻塞式的主循环，会导致冲突，建议删除turtle.exitonclick()，仅保留ekran.mainloop()即可。

4. 强制指定Turtle的Tkinter后端（可选） #

部分环境下Turtle默认后端打包后异常，可显式用Tkinter初始化：

import tkinter as tk
# 先初始化Tkinter根窗口并隐藏
root = tk.Tk()
root.withdraw()

ekran = turtle.Screen()
ekran.setup(800, 700)
ekran.cv._rootwindow.resizable(False, False)

5. 更新依赖库确保兼容性 #

更新PyInstaller到最新版本，避免版本兼容问题：

pip install --upgrade pyinstaller

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