如何将Visual Studio Code中开发的Python Tkinter游戏打包为可执行程序

最常用的工具：PyInstaller #

PyInstaller是把Python脚本打包成跨平台可执行文件的主流工具，适配Tkinter且操作简单。

1. 安装PyInstaller

打开终端（VS Code可使用内置终端），执行：

pip install pyinstaller

2. 基础打包（无外部资源）

假设游戏主脚本名为game.py，进入脚本所在目录后执行对应命令：

• 打包成单文件（适合分发，启动稍慢）：

  pyinstaller --onefile --windowed game.py
  

• 打包成文件夹（启动更快，文件体积分散）：

  pyinstaller --windowed game.py
  

说明：--windowed参数会隐藏运行时的命令行黑框，适配GUI程序；如需调试可去掉该参数。

3. 处理外部资源（图片、音效等）

如果游戏用到外部资源文件，必须告知PyInstaller一并打包：

• 方法一：命令行直接指定
  Windows系统用;分隔源路径和目标路径，Mac/Linux用:分隔：

  # Windows示例：打包assets文件夹下的logo.png
  pyinstaller --onefile --windowed --add-data "assets/logo.png;assets" game.py
  
  # Mac/Linux示例
  pyinstaller --onefile --windowed --add-data "assets/logo.png:assets" game.py
  

• 方法二：使用.spec文件（更灵活）
  1. 生成.spec配置文件：

     pyinstaller game.py
     

  2. 打开game.spec，找到datas列表并添加资源路径：

     datas=[('assets/logo.png', 'assets'), ('assets/bgm.mp3', 'assets')]
     

  3. 用.spec文件重新打包：

     pyinstaller game.spec
     

4. 修复打包后的资源路径问题

打包后程序会将资源放在临时目录，代码需适配路径避免找不到文件：

import sys
import os

def get_resource_path(relative_path):
    try:
        # 打包后的临时资源路径
        base_path = sys._MEIPASS
    except Exception:
        # 开发时的本地路径
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# 示例：加载图片
logo_img = tk.PhotoImage(file=get_resource_path("assets/logo.png"))

5. 自定义程序图标

• Windows：准备.ico格式图标，打包时添加参数：

  pyinstaller --onefile --windowed --icon=game_icon.ico game.py
  

• Mac：准备.icns格式图标，打包时添加参数：

  pyinstaller --onefile --windowed --icon=game_icon.icns game.py
  

6. 测试与分发

打包完成后，可执行文件生成在dist文件夹中：

• Windows：dist/game.exe
• Mac：dist/game.app
• Linux：dist/game
  测试功能正常后，即可上传至GitHub等平台供他人下载直接运行。

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