exe 打包后配置写不进、日志总丢?先分清只读资源与用户数据两个目录
一句话结论 只读资源跟着 exe 走,用户配置和日志写进 %APPDATA%,安装目录只放程序,能躲开多数写权限报错。
脚本在自己电脑上读写 config.json 一直正常,打成 exe 发给同事,画风立刻变了:界面里改了配置,重启又回到默认值;每天写的日志隔天找不到;有的干脆弹一行 PermissionError: [Errno 13] Permission denied 就退出。多数人第一反应是打包时漏了文件,回去把配置重新塞进工程再打一次,问题照旧。真正变掉的不是包里有没有这个文件,而是 exe 跑起来之后,程序眼里的『当前目录』和写脚本时眼里的那个目录,已经不是同一个位置。
判断这类问题该看什么,可以压缩成一句:把『读』和『写』拆成两件事,再给每件事各指定一个固定目录。读的是图标、模板、内置字典这些随程序一起交付的只读资源,它们跟着 exe 走;写的是用户配置、运行日志、缓存、sqlite 数据库这些会变的数据,得落在程序之外、当前账号有写权限的地方。两件事共用一条相对路径,是绝大多数打包后读写异常的起点。
一、判断标准:先认清 exe 运行时会碰到的几个目录
混淆这几个位置最容易出事,先把它们的典型取值和权限摊开看一遍。
| 目录 | 打包后典型取值 | 写权限 | 生命周期 | 该放什么 |
|---|---|---|---|---|
| exe 所在目录(sys.executable 同级) | C:\Program Files\YourApp\ 或同事随手放的文件夹 | 装在 Program Files 时普通用户无写权限 | 随安装、卸载 | 程序本体、只读资源 |
| 单文件解压的临时目录(sys._MEIPASS) | C:\Users\xx\AppData\Local\Temp\_MEIxxxxxx | 可写但随时被清 | 进程退出即回收 | 只放解压出来的只读依赖 |
| 当前工作目录(os.getcwd()) | 双击时可能是桌面,从开始菜单或计划任务启动时可能是 C:\Windows\System32 | 不稳定 | 随启动方式变 | 不该依赖它存任何东西 |
| 用户数据目录(%APPDATA% / %LOCALAPPDATA%) | C:\Users\xx\AppData\Roaming\YourApp\ | 当前账号可写 | 跨升级保留 | 配置、日志、缓存、数据库 |
这张表是 Python 与 Windows 平台的通用目录规则,跟用 PyInstaller 还是 Nuitka、跟哪一款打包工具都没有关系。单文件模式下 PyInstaller 会把依赖解压到 _MEI 开头的临时目录再运行,sys._MEIPASS 指向它;源码方式运行时这个属性不存在,一般用 getattr(sys, '_MEIPASS', ...) 做回退。把日志写进这个临时目录,进程一退出就可能连同目录一起被清掉,这正是『隔天找不到日志』的常见来源。os.getcwd() 更不可靠,它的值由启动方式决定,从计划任务拉起的程序常拿到 System32。
只读资源放进包里,用户数据写到包外
落到代码上通常拆成两个函数:resource_path(rel) 负责读,用 sys._MEIPASS 或 exe 所在目录拼只读资源;user_data_dir() 负责写,读 os.environ['APPDATA'] 拼一个以程序名命名的子目录,先 mkdir(parents=True, exist_ok=True) 再往里写。配置和日志的写入入口全部换到后者,代码里不再出现 './config.json' 这类相对路径。这段路径处理属于 Python 与 PyInstaller / Nuitka 的公开通用做法,要自己写进脚本,任何打包工具都不会替你改业务代码。
哪些症状属于这一类,哪些不是
分界也要划清。双击就闪退、报 ModuleNotFoundError,多半是依赖没被收进包,属于打包环节,可以照《Python 脚本打包成 exe 后双击闪退?缺依赖、路径、运行库三步定位》的三步走;控制台里中文变问号、路径带中文就读写失败,是编码与代码页问题,《Python 打包 exe 后中文乱码?按控制台、文件、路径三层定位再改》按三层拆过。这一类只在『程序已经正常启动、界面也能打开,一读写就出错或数据不落地』时成立,三类问题的处理方式不同,混在一起排查只会来回重打包。
二、工具落点:智包大师接住『目标机能跑』这一段
目录策略定了,还有个前置问题:目标机器上没有 Python,py 文件双击打不开,路径写得再规范也跑不起来。《智包大师,一个简单易用的python打包工具》处理的是这一段,把脚本连同依赖收成 exe 或带快捷方式的安装包。它是 Windows 桌面软件,只跑 Win10/11 64 位,下载在 zhibao.hl22.com,官网没公布价格,按页面说明获取即可。
和读写问题直接相关的有几项。AST 扫源码找依赖,动态导入也能揪出来,程序搬到没开发环境的机器上不会因为少一个库起不来;打包前会出一份体检报告,依赖和路径先过一遍,写死在脚本里的资源路径在这时候最容易暴露。Nuitka 与 PyInstaller 双引擎在同一工程里切换,PyTorch 这类大库更适合 PyInstaller,追求体积与反编译难度可以切 Nuitka,取舍可看《Nuitka和PyInstaller怎么选?Python打包工具对比与组合用法》,工程怎么组织在《Python 打包工具怎么选?智包大师把脚本一键打包成 exe》里写过。图标拖进界面,版本号与管理员权限在表单里填,内置 Inno Setup 会生成带快捷方式的安装包。排障期可以保留控制台窗口,跑通后再改无窗口,这样能看到 PermissionError 的完整堆栈。
边界要写明白。sys._MEIPASS、%APPDATA%、Program Files 的默认写权限、UAC 虚拟化这些,是 Python 与 Windows 平台的通行规则,不是智包大师的功能;工具也不会自动把配置迁移到用户目录,resource_path 和 user_data_dir 得自己在脚本里实现。它解决的是依赖收得齐、路径问题在体检报告里提前露出、目标机不需要装 Python,以及安装包能按填的权限要求装好。运行时数据往哪写、升级时怎么保住旧配置,仍是代码层的决定。
三、操作步骤:把读写路径拆两处,再打一次包
把上面两步合起来走一遍,顺序如下。
在脚本里加 resource_path(rel) 和 user_data_dir() 两个函数,读资源走前者,写数据走后者,删掉所有 './' 开头的相对路径。
把图标、模板、字典等只读资源用打包工具的 --add-data / datas 收进工程,读取处统一调 resource_path();这一步是 PyInstaller / Nuitka 的通用参数,不是界面开关。
打开智包大师,把主脚本和图标拖进界面,表单里填好版本号;只有确实需要写注册表或系统目录时才勾管理员权限,普通工具别勾,勾了也代替不了用户目录。
看打包前的体检报告,确认依赖、动态导入、资源路径都列全,尤其检查有没有把配置文件误当成只读资源塞进包里。
开发阶段用 PyInstaller 引擎先出一版验证路径与依赖,正式包再按《Nuitka和PyInstaller怎么选?Python打包工具对比与组合用法》的组合用法切 Nuitka;单文件模式记得别往临时目录写数据。
生成 exe 和 Inno Setup 安装包,保留控制台窗口,在目标机上把配置改一次、重启程序,确认改动还在、日志落在 %APPDATA% 而不是安装目录。
跑通后再去掉控制台窗口,重新出正式包;升级时沿用同一套 user_data_dir(),覆盖安装不会把用户配置一起清掉,这一点在《脚本改了一行还要整包重发吗?覆盖安装、增量更新、重新打包怎么选》里讨论过。
打包前自检清单
代码里还有没有 os.getcwd() 或相对路径参与写文件
只读资源是否都走了 resource_path()
安装包默认装到 Program Files 时,写操作是否全部落在用户目录
体检报告里有没有漏掉的动态导入与资源文件
从开始菜单、计划任务两种启动方式各试一次,别只测双击
换一个 Windows 账号登录,确认配置按账号隔离、日志不串
第 5 步和第 7 步别省。计划任务或 Windows 服务拉起程序时,工作目录常常不是 exe 所在目录,只测双击会漏掉这一类,《exe 打包好了怎么开机自启常驻?登录启动、计划任务、Windows 服务按场景分》里三种常驻挂法都要单独确认工作目录。体积与冷启动的取舍可以参照《打包 exe 几百 MB 还启动慢?先量解压耗时,再砍依赖体积》,首次交付给同事打不开的常见原因在《Python 脚本发给同事打不开?一键打包 exe 与安装包实操》。
四、常见报错对照与限制说明
把高频症状和成因对上,能少走不少弯路。
| 症状 | 常见成因 | 先查哪里 |
|---|---|---|
| PermissionError: [Errno 13],装在 Program Files 后出现 | 往安装目录或 exe 同目录写配置 | 写路径改到 %APPDATA% |
| FileNotFoundError,双击正常、从计划任务启动就报 | 用 os.getcwd() 或相对路径拼资源 | 换成 resource_path() 与绝对路径 |
| 配置改了不生效,重启回到默认 | 写进了 _MEI 临时目录,进程退出被清 | 配置与日志改走 user_data_dir() |
| 日志隔天消失 | 同上,或写到了系统临时目录 | 改用 %LOCALAPPDATA% 子目录 |
| 换账号登录后读不到旧配置 | 配置按账号存在 Roaming 下 | 需要共享就单独指定公共目录并给权限 |
做不到的事也要说清楚。智包大师只跑 Win10/11 64 位,目标机是 Win7、32 位系统或 macOS / Linux,得另找方案,路径规则可以照搬但打包这一步不适用;官网没有公布价格,不要按别处的数字估算。它也不会替你做配置迁移、多用户数据合并、日志轮转这些代码层的活,要自己在脚本里写。把打包工具的职责和脚本的职责分开,比换一款工具更省时间。
五、下一步
如果只是想让脚本在同事的电脑上双击就能跑,可以先到 zhibao.hl22.com 看看智包大师的界面和打包前的体检报告长什么样,官网未公布价格,按页面说明获取即可,软件仅支持 Win10/11 64 位。打包环节理顺之后,再回头把两个路径函数补进脚本,用一台干净的目标机按上面 7 步走一遍。exe 发出去之后的多数问题,基本落在依赖、编码、目录、运行形态这四类里,站内几篇旧文分别拆过,可以按需翻。

如果这篇文章对你有帮助,欢迎打赏支持一下~
智包大师,一个简单易用的python打包工具
智包大师想把 Python 打包的体力活全包了。写好的脚本发给同事,对方根本打不开。手动敲命令打包又太折腾:参数难记、依赖总…
评论留言(0)