PyInstaller是Windows下最稳定、兼容性最好的Python打包工具，需用venv环境、正确处理路径和资源文件、添加异常日志才能确保.exe在干净系统中正常运行。
用 pyinstaller 打包最直接，别碰其他工具
VS Code 本身不提供打包功能，它只是编辑器。真正把 .py 变成 .exe 靠的是第三方打包工具，pyinstaller 是目前 Windows 下最稳定、兼容性最好、出问题容易查的方案。别被“Auto-py-to-exe”这类图形界面工具带偏——它们底层还是调 pyinstaller，反而多一层封装，报错时你更难定位。
常见错误现象：ModuleNotFoundError、图标不显示、双击闪退、打包后程序找不到数据文件。这些问题基本都出在路径处理或依赖没识别全，不是 VS Code 设置的问题。
- 先确保 Python 环境干净：用项目专属的
venv，而不是全局 Python - 在 VS Code 终端里运行命令，别用系统 CMD 或 PowerShell 单独开窗口（避免环境不一致）
- 打包前先用
python script.py跑通，否则打包成功也没用
pyinstaller 基础命令怎么写才不翻车
最简能跑起来的命令是：pyinstaller --onefile script.py。但实际几乎没人只用这句——因为会缺图标、控制台乱跳、找不到资源文件。关键参数得按需加：
-
--onefile：打成单个.exe，但启动稍慢（解压到临时目录），适合分发；不用它就生成一堆文件+一个主 exe，调试方便 -
--windowed：隐藏黑窗口（适合 GUI 程序），但用了之后 print 不会输出到控制台，调试时建议先去掉 -
--icon=app.ico：图标必须是.ico格式，路径要相对当前终端位置，不是相对于.py文件 -
--add-data "data;data"（Windows）：把data/文件夹打进包里，运行时要用sys._MEIPASS拼路径，不能直接写"data/config.json"
示例（带图标+隐藏控制台）：pyinstaller --onefile --windowed --icon=logo.ico main.py
打包后找不到文件？路径逻辑和开发时不一致
这是最高频的坑：代码里写 open("config.json") 在开发时能跑，打包后直接报错。因为 .exe 运行时的当前工作目录不等于你的源码目录，也不是 .exe 所在目录。
正确做法是统一用以下模式获取资源路径：
import sys
import os
<p>def resource_path(relative_path):
if getattr(sys, 'frozen', False):
base_path = sys._MEIPASS
else:
base_path = os.path.abspath(".")
return os.path.join(base_path, relative_path)</p><h1>用法</h1><p>config_path = resource_path("config.json")
with open(config_path) as f:
data = json.load(f)</p>注意：sys._MEIPASS 只在打包后存在，开发时走 os.path.abspath(".") 分支；--add-data 的路径必须和这里传入的 relative_path 对得上。
为什么有时候打包完双击就闪退？怎么看日志
闪退通常是因为异常没被捕获，而 --windowed 又关了控制台，导致你看不到报错信息。临时排查方法很简单：
- 删掉
--windowed参数重新打包，双击就能看到报错堆栈 - 或者在代码最外层加 try/except，把异常写进日志文件：
with open("error.log", "a") as f: f.write(traceback.format_exc()) - 别信“打包成功”就万事大吉——一定要在**没装 Python、没配环境变量的干净 Win10/11 机器上测试**，这才是真实用户场景
另外，某些 anti-virus 软件会误报 pyinstaller 打的包为风险程序，这不是你代码有问题，是签名缺失。个人小工具可忽略；商用需考虑加数字签名或换 cx_Freeze（但兼容性更差）。
路径处理、资源加载、异常捕获这三块没理清楚，打包出来的 .exe 就算能点开，也大概率在别人电脑上走不通。
