PySimpleGUI 4.60.5免费版安装指南：避开5.0收费坑与常见错误

简介：PySimpleGUI 4.60.5 免费老版本安装包，可解决目前 PySimpleGUI 5.0 及以上版本收费、打包为 exe 后仍提示试用 30 天的问题，适合需要免费使用该 GUI 库的 Python 开发者及入门学习者。包内共 13 个文件，以 py 源码、txt 说明、PKG-INFO、egg 及 cfg 配置为主，整体压缩包约 1.81MB，结构清晰，包含 setup.py 等标准安装文件。已有 1391 人学习下载，资源附带详细的本地安装路径指引：解压后进入包含 setup.py 的目录，执行带空格的 pip install . 即可完成安装。通过该资源，读者可永久免费使用 4.60.5 稳定版，摆脱新版本授权限制，快速上手 PySimpleGUI 提供的窗口、按钮、表格等图形界面组件，适合用于数据可视化、系统监控等桌面应用开发场景。

1. PySimpleGUI 4.60.5 与 5.0：免费和收费的分水岭，老版本为什么反而更省心

先给出反直觉结论：装 PySimpleGUI 的时候，直接pip install PySimpleGUI拉最新版并不是默认正确操作。PySimpleGUI 从 5.0 开始切换为收费授权，安装包里带了许可证校验逻辑，普通开发者在本地体验时感觉不明显，一旦要把程序打包发给同事或客户，就会撞上授权提示。而 4.60.5 属于 4.x 末期的成熟版本，依旧保持免费下载、免费使用、免费打包的分发方式，对内部工具、教学 Demo、小型桌面应用来说，功能完全够用。下面会讲清楚为什么要选 4.60.5、三种安装命令怎么写、装完怎么验证，以及最容易翻车的五个场景。

2. 为什么说 4.60.5 是最稳妥的免费版本：授权变化与选型逻辑

2.1 5.0 的收费到底卡在哪：许可证校验与分发限制

5.0 之后，项目从原来的免费授权转向商业授权。这里有个容易误解的点：收费不等于装不上，「pip 能装到 5.x」和「你能合法使用 5.x」是两回事。5.0 安装包仍然能拿到，但使用时会有授权校验逻辑；如果把基于 5.0 写的工具打包后分发给别人，分发环节同样会被校验拦住。

对普通开发者的实际影响要分场景看。自己电脑上写着玩、跑个脚本、做课程作业，影响不大；但只要是「做给别的部门用、做给客户用、放到生产环境」的工具，5.0 就会让你在启动或分发阶段停下来处理授权。很多开发者踩坑都是同一个路径：先 pip 装了最新版、代码写完了、打包也成功了，结果目标机器上启动报错，回溯半天才发现是版本授权问题。

而 4.60.5 是 4.x 版本线里的成熟期版本，沿用旧的免费授权逻辑，安装即用，不校验、不弹提示、不限制分发。至少在当前阶段，它是「能免费拿到、能放心打包」的版本线里比较成熟的一个节点。这也是标题里「老版本免费」的实际含义，不是某个人的偏好，而是授权边界本身发生了变化。

再补一个选版本号的经验：4.60.5 是 4.x 这条版本线里比较靠后的版本号。选老版本时尽量选版本线后期的版本，而不是早期版本。原因很简单：越晚的 4.x 修掉的 bug 越多，而且 API 早已固定，网上搜到的 4.x 示例代码基本都能直接跑。5.0 之后 API 有调整，老示例不一定兼容，这也反向说明 4.60.5 是 4.x 线上最不容易踩坑的选择。

2.2 4.60.5 还够用吗：常用功能对照表

担心老版本缺功能的人不少，实际对照一下常用能力就清楚了。PySimpleGUI 的核心设计是「用简单代码搭桌面界面」，这个定位在 4.x 末期已经成型，4.60.5 覆盖日常工具开发需要的绝大部分能力。

这张表其实说明了另一个结论：PySimpleGUI 的核心 API 在 4.x 后期已经固化。从 4.60.5 开始学写界面，学的布局思路、事件循环写法，放到 4.x 任何后期版本都一样，不会被老版本的特殊行为坑到。网上能找到的 PySimpleGUI 教程，绝大多数基于 4.x 编写，这些代码在 4.60.5 上的兼容性是最好的。把表格看一遍就会发现：写报表工具、文件整理工具、小游戏、教学演示、内部配置面板，4.60.5 完全够用。它缺少的是 5.x 新增的那部分组件和更细的界面修饰能力，而这些通常只在做对外发布的精美商业产品时才有价值。

2.3 选型判断：哪种场景坚持 4.60.5，哪种场景该换方向

选版本本质上是选授权边界和功能边界的交集。我一般按三个场景来判断。

第一个场景是内部工具和教学 Demo。这类程序不发版、不分发，功能以「快速写出来能用」为主，4.60.5 是最合适的，装了就能写，不需要处理授权，也不需要因为新版本改动调整已有代码。第二个场景是给部门或客户交付的小工具。如果对方机器上没有 Python 环境，你需要打包成独立程序，这时候 4.60.5 的免费分发价值就体现出来了。我会优先用 4.60.5 加打包工具出产物，分发路径最干净。第三个场景是商业产品或者对界面精细度要求很高的应用，老版本可能不够，5.x 的新功能又需要付费。我的建议是别急着为 PySimpleGUI 付费，先评估项目能不能换到标准库 Tkinter 或主流 UI 绑定上去写。GUI 方案选型是整体工程决策，不要因为「装个新版本」就把授权成本带进项目。

判断要不要坚持 4.60.5，还有一个很现实的角度：你写这个 GUI 是写给谁用的。给自己用、给同行在同样环境里跑，版本号根本不重要；给别人用，版本和打包方式就变成交付的一部分，必须提前决定。我见过不少项目，一开始随手装了新版，写到一半发现要分发，再回头降级，中间因为 API 差异改了不少代码。这类返工完全可以避免，只要动手前先回答一个问题：这个程序最终在什么机器上、以什么方式运行。

3. 安装 4.60.5 老版本：三条可直接抄的命令与参数说明

3.1 最小安装命令：pip 精确锁版本

安装 4.60.5 的最小命令只有一个：

# 精确锁版本，不允许 pip 自动选更高版本 pip install PySimpleGUI==4.60.5

这里的==是精确匹配，意思是指定 pip 安装 4.60.5 这一个版本。很多人会写错成pip install PySimpleGUI 4.60.5，中间少了==，pip 会把 4.60.5 当成另一个包名去解析，结果是既没装上目标版本，还可能把最新版装进去。这个细节是第一道坑。

命令里的参数可以按需加。习惯上我会加一个--no-cache-dir：

# python -m pip 保证 pip 与当前解释器属于同一环境 python -m pip install --no-cache-dir PySimpleGUI==4.60.5

python -m pip是为了避免系统里多个 Python 时装错地方，这是个低成本高收益的习惯。--no-cache-dir跳过本地缓存，防止旧缓存干扰版本选择。如果之前装过 5.0，建议先执行pip uninstall PySimpleGUI再装，确保干净覆盖。

3.2 不锁版本会装到 5.x：两个命令确认可用版本

不指定版本直接执行pip install PySimpleGUI，pip 会把当前索引里最新的 5.x 装进来。要确认自己环境里能拿到哪些版本，用下面两个命令之一：

# 新版 pip 直接列版本 pip index versions PySimpleGUI # 旧版 pip 用这行触发报错，从报错信息里找版本列表 pip install PySimpleGUI==

这两个命令解决的是同一个问题：确认安装源和网络链路是通的。很多安装失败不是命令写错，而是索引源不可用或网络受限，导致 pip 拿不到版本列表。先查版本再看报错，排错效率会高很多。

提示：pip index versions需要较新的 pip。旧版本 pip 用pip install PySimpleGUI==触发报错，错误信息里会列出全部可用版本，这是兼容性最好的办法。

看到列表里有 4.60.5，再执行精确安装，路径就清楚了。如果列表里没有 4.60.5，说明当前索引源同步不完整，需要换源或稍后再试，不要强行安装一个不确定的版本。

3.3 虚拟环境 + requirements.txt 把版本钉死

如果这个 PySimpleGUI 项目会持续维护，我建议不要只在命令行里装一次，而是创建一个虚拟环境，并把版本写进依赖清单。常见的做法是：

python -m venv .venv source .venv/bin/activate # Windows 下激活命令换成 .venv\Scripts\activate

激活之后再用pip install PySimpleGUI==4.60.5安装，此时所有包都落在.venv目录里，不会污染系统 Python。紧接着在项目根目录创建一个requirements.txt，写入：

PySimpleGUI==4.60.5

以后换机器、换同事接手，只需要执行pip install -r requirements.txt，装出来的就是同一个版本。PySimpleGUI 4.x 默认走标准库 Tkinter，没有复杂的第三方依赖链，所以这个清单里只需要锁自身版本就够。这个习惯看起来多花两分钟，但对后续排错来说价值非常大，尤其是团队里多个人同时开发时，版本不一致是最难排查的问题之一。

3.4 网络慢与超时：加超时参数与换索引源

安装时最常见的挫败感是下载卡住。默认索引源在某些网络环境下访问时快时慢，虽然 PySimpleGUI 是小型纯 Python 包，但元数据请求阶段也会出现长时间停在 Downloading 或 Collecting 的情况。

# --timeout 60 把单次请求超时拉长，-i 换成你网络可达的国内镜像 pip install PySimpleGUI==4.60.5 --timeout 60 -i <你的国内镜像地址>

--timeout 60避免 pip 因默认 15 秒超时频繁重试；-i指定索引源，换成国内镜像后元数据和安装包都会快很多。如果不想每次敲-i，可以用pip config set global.index-url <镜像地址>写入全局配置。

注意一个边界：换索引源只是解决网络速度，不会改变版本内容。镜像站按上游同步，安装后可以靠第四章里的版本校验确认结果。我一般会先试默认源，卡住超过 30 秒就切镜像，不要反复重试同一个源，浪费时间且容易把缓存搞得一团糟。

4. 装完先别写业务代码：三个步骤验证 4.60.5 真的生效

4.1 导入与版本号：一条命令确认 4.60.5

安装完成后，先确认导入路径和版本号正确：

# 输出 4.60.5 才算安装成功 python -c "import PySimpleGUI as sg; print(sg.__version__)"

如果输出是4.60.5，说明环境里生效的就是目标版本。注意大小写，包的导入名是PySimpleGUI，写成全小写pysimplegui会触发导入错误，容易误判为安装失败。这个命令我在每次换环境后都会跑一遍，原因很简单：版本号是后续所有排错的前提，版本不对后面全是黑匣子。

如果输出是5.x.x，说明装错了环境或装完后又被升级。先执行pip uninstall PySimpleGUI清掉，再按 3.1 的命令重新安装。别跳过这步直接写代码，否则你写完几十行界面才发现跑在 5.0 上，返工成本就高了。还有一种情况是系统 PATH 里混着多个 Python，python指向解释器 A，pip却属于解释器 B，这时候用python -m pip install可以规避大部分由 PATH 混乱导致的装错环境问题。

4.2 最小 GUI 窗口：跑通窗口与事件循环

版本确认后，跑一个最小窗口验证 GUI 链路完整：

import PySimpleGUI as sg # 布局：一行文本 + 一行按钮 layout = [[sg.Text("PySimpleGUI 4.60.5 is ready")], [sg.Button("Close")]] window = sg.Window("Version Check", layout) while True: event, values = window.read() # 阻塞等待用户操作 # 点关闭按钮或窗口右上角 X 都退出 if event in (sg.WIN_CLOSED, "Close"): break window.close()

这段代码做的事非常少，但覆盖了 PySimpleGUI 的核心机制：layout是二维列表，每一行对应界面上一行控件；sg.Window创建窗口；window.read()阻塞等待用户操作，返回事件名和输入值；点关闭按钮或窗口右上角 X 时，事件命中sg.WIN_CLOSED或按钮名，循环结束，window.close()释放窗口资源。

如果这个窗口能正常弹出并关闭，说明 Tkinter 后端、事件循环、控件布局三条链路都通。任何一条有问题，都会在这个最小例子里暴露，而不是在你写到一半的复杂界面里暴露。我曾经遇到过一次窗口能创建但read()直接返回 None 的情况，就是 Tkinter 后端版本与 PySimpleGUI 不匹配造成的，最小窗口能帮你把问题隔离到最简范围。

4.3 打包分发视角：确认依赖没混入 5.x

如果计划把程序打包后发给别人，还需要从打包视角确认一次环境纯净度：

pip show PySimpleGUI python -m pip list 2>/dev/null | grep -i pysimplegui

pip show输出里的 Version 字段应该是 4.60.5。再用pip list看一眼完整环境，确认没有其他版本的 PySimpleGUI 残留在相同环境中。打包工具在收集依赖时，通常以当前解释器环境里的包为准，环境里混着两个版本会导致打包结果不可预测，这也是「开发环境正常、目标机器报错」的常见来源。

我一般会额外确认目标机器的 Python 版本与开发环境一致。PySimpleGUI 4.x 是纯 Python 包，对解释器版本没有苛刻要求，但目标机器上的 Python 如果缺 Tkinter 标准库组件，界面代码仍然会启动失败。这一步的验证点是「依赖与运行环境」，不只是版本号。打包前花两分钟检查，比打包后让同事装一个打不开的产物要省心得多。

5. 安装 4.60.5 的避坑清单：五个真实翻车现场与排查路径

5.1 指定了 4.60.5，装出来却是 5.x

现象：执行安装命令时没有报错，但导入打印版本号是 5.x，或者程序运行时出现授权提示。

原因：多数情况是环境里已经装过 PySimpleGUI，pip 认为目标版本已存在就跳过了安装；少部分是命令写成了pip install PySimpleGUI 4.60.5，缺少==，4.60.5 被当成额外包名，解析失败后 pip 仍然安装了最新版。

解决：先卸载再装，顺序执行pip uninstall PySimpleGUI，接着执行pip install --no-cache-dir PySimpleGUI==4.60.5。装完立即用 4.1 的命令打印版本号确认。如果是在虚拟环境里，还要确认 activate 成功，用which pip确认指向的是.venv下的路径，而不是系统路径。

5.2 下载卡住或超时

现象：命令行长时间停在 Downloading 或 Collecting，最后抛超时异常，或者反复重试后失败。

原因：默认索引源在当前网络下访问时快时慢，元数据或安装包无法按时拉取，这不代表命令写错。

解决：给命令补充网络参数，优先尝试--timeout 60 --retries 5，或者直接换国内镜像源。也可以彻底绕开网络，在有网环境用pip download PySimpleGUI==4.60.5 -d ./vendor拉取安装包到本地，再在目标机器上执行pip install --no-index --find-links=./vendor PySimpleGUI==4.60.5。离线方案看起来多一步，但在内网环境里反而最省时间，而且版本结果完全可控。

5.3 报错 no matching distribution

现象：pip 提示找不到 4.60.5 这个版本，或者找不到 PySimpleGUI 这个包。

原因：常见于索引源同步不完整导致版本列表缺失，极少数情况是网络请求被过滤导致元数据返回异常。PySimpleGUI 是纯 Python 包，对 Python 版本要求不苛刻，所以基本不是解释器版本问题。

解决：先确认拼写，包名是PySimpleGUI，保持官方写法。再换一个索引源重试，或者用 3.2 的版本列表命令确认索引里确实存在 4.60.5。换源后可见版本正常，问题就定位在原索引源同步节奏上。如果多个源都找不到，才需要怀疑网络中间层，尝试修改 pip 的超时和重试参数再查一次。

5.4 导入成功但启动窗口时提示 tkinter 缺失

现象：安装顺利，import PySimpleGUI也不报错，但创建窗口时提示找不到 Tkinter 相关模块，最常见的是ModuleNotFoundError: No module named 'tkinter'。

原因：Python 解释器本身没有绑定 Tkinter。Windows 和 macOS 的官方安装包默认带 Tkinter，Linux 的某些发行版或精简版 Python 环境需要单独安装系统包，缺失时解释器不会自动补上。

解决：在 Linux 环境，按发行版补装 tk 支持包，装完用python -m tkinter验证是否能弹出小窗口。如果无法安装系统包，另一个方向是换用带 Tkinter 的 Python 发行版，但这会改变整个环境的构建方式，需要评估是否影响其他项目。验证最小窗口的逻辑见 4.2，这一步能确认 Tkinter 链路是否真的恢复。

5.5 项目前一天还能跑，次日启动出现授权提示

现象：代码没改，环境没动，启动时突然弹出许可证相关提示，或者界面部分功能不可用。检查后发现环境里的 PySimpleGUI 变成了 5.x。

原因：某个依赖安装过程把 PySimpleGUI 升级到了最新版，或者有人手动执行pip install PySimpleGUI时没锁版本。pip 默认解析策略倾向于装最新版，只要有一次不带==的安装动作，就可能覆盖旧版本。

解决：把 4.60.5 写进requirements.txt并纳入版本管理，杜绝裸装命令。已经发生覆盖时，执行pip install --force-reinstall --no-deps PySimpleGUI==4.60.5强制回到目标版本。这件事的核心教训是：版本固定要落在清单里，不能只靠脑子里记住一个数字。

6. 进阶：把 4.60.5 变成离线可复现底包，团队不再翻车

如果只有你一个人写脚本，第五章里的临时修复足够用了。但只要是团队项目或者要部署到多台机器，我就会把 PySimpleGUI 4.60.5 做成一个离线底包，让所有人从同一份文件安装，绕开索引波动和版本漂移。

第一步，在有网络的机器上把安装包下载到本地目录：

# 创建 vendor 目录存放 wheel 文件 mkdir -p vendor pip download PySimpleGUI==4.60.5 -d vendor

-d指定输出目录，下载产物是 wheel 格式，一次下载可以反复使用。第二步，在目标机器上离线安装：

# --no-index 禁止访问在线索引，--find-links 只从本地目录找包 pip install --no-index --find-links=./vendor PySimpleGUI==4.60.5

--no-index告诉 pip 不要访问在线索引，--find-links让它只从本地目录找包。两条参数配合，安装过程完全离线，结果只取决于 vendor 目录里的文件。把 vendor 目录提交到你们自己的配置仓库，新机器拉下来就能复现同一个环境，不再依赖任何外部网络状态。

这个习惯我是从一个小工具开始养成的。当时团队里有台机器总是装出 5.x，查了半天是镜像同步延迟造成版本列表不一致。后来我把 4.60.5 下载成离线底包，这个问题再没出现过。我现在的习惯是：任何 GUI 工具代码，第一件事就是固定版本号，第二件事就是把安装方式写进项目说明，而不是依赖每个人记住「要装老版本」。版本钉死之后，排错时少一个变量，问题定位会快很多。希望帮到你。

本文还有配套的精品资源，点击获取