Python脚本免安装环境启动器是一款专为Python开发者设计,旨在解决Python环境配置复杂、依赖管理繁琐的问题。
本工具允许用户在无需安装Python的情况下,通过便携式Python环境运行Python脚本,并自动检测和安装脚本所需的依赖模块。
提供完整的Python环境管理功能:自动发现本地便携式Python环境、支持脚本拖拽选择、智能解析脚本依赖、一键安装缺失模块、支持多种国内镜像源加速下载。工具特别针对PaddleOCR和PaddleNLP等深度学习框架进行了版本兼容性检测,确保依赖包版本匹配。
适用于:非专业人员,要在没有安装python环境的电脑上使用,拿到一个py源代码后不知道怎么使用的情况,或者打包时各种出错,分发时使用。
建议:放到一个位置后不再移动,因为文件有些大,约8G大小,后续各种库安装等会更大
功能特点
便携式Python环境管理:
工具能够自动扫描程序目录下的python文件夹,识别其中的Python环境(如python_3.8.6x64),自动区分32位和64位环境供选择。
智能依赖检测:
使用Python的AST(抽象语法树)模块解析脚本中的import语句,提取顶级模块名称,并自动过滤标准库模块,只检测第三方依赖。
一键依赖安装:检测到缺失模块后,可一键安装所有缺失依赖。安装过程使用pip工具,支持选择多种国内镜像源(清华、阿里云、中科大、华为云、豆瓣)加速下载,大幅提升安装速度。
版本兼容性检测:
针对PaddleOCR和PaddleNLP等特殊依赖,工具会自动检测已安装版本是否符合要求。
例如,检测到paddleocr依赖时,会验证paddlepaddle版本是否为2.x;检测到paddlenlp时,会验证版本是否小于2.8.0,避免版本不兼容导致的运行错误。
灵活的版本选择:双击缺失模块列表中的项目,可查询该模块的所有可用版本,可选择指定版本进行安装,满足特定版本需求。
脚本拖拽支持:支持将.py文件直接拖拽到输入框中选择脚本,提升操作便捷性。
实时日志输出:所有操作过程(环境切换、依赖检测、模块安装、脚本运行)都会实时输出到日志区域,方便了解执行状态和排查问题。
多线程执行:依赖检测、模块安装、脚本运行等耗时操作均在后台线程执行,避免界面卡顿,保证用户体验流畅。
详细使用说明
环境选择功能
程序启动时会自动扫描程序目录下python文件夹中的所有子目录,查找python.exe(Windows)或python(Linux/macOS)可执行文件。每个有效的Python环境将以单选按钮形式展示,显示名称格式为”位数 (目录名)”,如”64位 (python_3.8.6x64)”。
切换环境时,日志区域会记录环境变更信息,包括环境名称和可执行文件路径。
脚本选择功能
脚本选择支持三种方式:
- 文件对话框选择:点击”浏览…”按钮打开文件选择对话框,支持筛选.py文件
- 手动输入:直接在输入框中输入完整的脚本文件路径
- 拖拽选择:将.py文件从资源管理器拖拽到输入框,程序会自动验证文件类型
依赖检测功能
依赖检测采用静态分析方法,使用AST模块解析脚本源码,提取所有import和from…import语句中的顶级模块名。检测过程会自动过滤以下标准库模块:os、sys、math、time、json、re、subprocess、threading、tkinter、pathlib、itertools、functools、collections、logging、datetime、typing、random、enum、http、unittest、webbrowser、ast等。
对于每个疑似第三方模块,程序会在目标Python环境中尝试导入,判断是否已安装。
特殊依赖兼容性检测
对于以下特殊依赖,程序会进行额外的版本兼容性检测:
| 依赖模块 | 兼容性要求 | 处理方式 |
|---|---|---|
| paddleocr | paddlepaddle版本需为2.x | 检测版本,不兼容时提示安装paddlepaddle==2.6.2 |
| paddlenlp | 版本需小于2.8.0 | 检测版本,不兼容时提示安装paddlenlp<2.8 |
依赖安装功能
安装依赖时,程序会调用所选Python环境的pip模块执行安装命令。安装命令格式为:
python.exe -m pip install 模块名 -i 镜像源地址
对于paddlenlp模块,程序会自动将安装目标调整为”paddlenlp<2.8”,以避免tool-helpers依赖问题。
指定版本安装
双击缺失模块列表中的项目,程序会查询该模块的所有可用版本,弹出对话框显示版本列表。用户可输入指定版本号进行安装,格式为”模块名==版本号”。
镜像源选择
程序内置以下镜像源选项:
建议国内用户选择清华TUNA或阿里云镜像源,下载速度更快更稳定。
脚本运行功能
运行脚本时,程序会清理可能从PyInstaller继承的Tcl/Tk环境变量(TCL_LIBRARY、TK_LIBRARY、TKDND_LIBRARY),避免版本冲突。脚本的工作目录设置为脚本所在目录,确保相对路径正确解析。
脚本的标准输出和标准错误会实时显示在日志区域,运行结束后显示退出码。
使用场景示例
场景一:运行PaddleOCR文字识别脚本
用户下载了一个使用PaddleOCR进行图片文字识别的Python脚本,但本地没有安装Python环境。
- 将便携式Python环境(python_3.8.6x64)放入程序的python目录
- 启动程序,选择64位Python环境
- 选择OCR脚本文件
- 点击”检测依赖”,程序检测到缺失paddleocr和paddlepaddle模块
- 选择清华TUNA镜像源,点击”安装缺失依赖”
- 程序自动安装paddlepaddle==2.6.2和paddleocr,并进行版本兼容性验证
- 安装完成后点击”运行脚本”,开始执行文字识别任务
场景二:批量处理Excel文件的数据分析脚本
用户有一个使用pandas和openpyxl处理Excel文件的数据分析脚本,需要在多台电脑上运行。
- 将程序和便携式Python环境复制到U盘
- 在目标电脑上插入U盘,运行程序
- 选择Python环境,指定Excel处理脚本
- 检测依赖,发现缺失pandas和openpyxl
- 选择阿里云镜像源,一键安装依赖
- 运行脚本,处理Excel文件
- 整个过程无需在目标电脑上安装Python或配置环境
场景三:开发和测试多版本兼容的Python脚本
开发者需要测试脚本在不同Python版本下的兼容性。
- 准备多个版本的便携式Python环境(如3.8、3.9、3.10)
- 将这些环境放入程序的python目录
- 启动程序,选择不同版本的环境分别运行脚本
- 观察日志输出,检查兼容性问题
- 如有依赖缺失,针对各环境分别安装
注意事项
便携式Python环境要求:
程序目录下的python文件夹中必须包含完整的Python环境,且环境目录名建议包含位数标识(如”x64”、”x86”),以便程序正确识别32位/64位环境。
网络连接:安装依赖时需要稳定的网络连接。若使用官方默认源下载速度慢,请切换到国内镜像源。
依赖版本冲突:部分依赖包可能存在版本冲突,建议在独立的便携式Python环境中运行脚本,避免与系统Python环境产生冲突。
深度学习框架:PaddleOCR、PaddleNLP等深度学习框架对Python版本和依赖版本有特定要求,建议使用Python 3.8版本环境,并让程序自动处理版本兼容性问题。
数据安全:本程序所有操作均在本地执行,不联网上传任何数据。脚本运行过程中产生的数据完全由用户控制。
杀毒软件:部分杀毒软件可能误报便携式Python环境中的文件,请将程序目录添加到杀毒软件白名单中。常见问题解答
Q: 程序启动后没有显示任何Python环境选项?
A: 请检查程序目录下是否存在python文件夹,以及该文件夹中是否包含有效的Python环境。Python环境目录中必须包含python.exe(Windows)或python可执行文件。
Q: 依赖安装失败怎么办?
A: 请尝试以下解决方案:
- 切换镜像源,推荐使用清华TUNA或阿里云镜像
- 检查网络连接是否正常
- 查看日志区域的错误信息,根据提示处理
- 双击缺失模块,选择较低版本进行安装
Q: 运行脚本时提示模块找不到?
A: 请确保已点击”检测依赖”并安装所有缺失模块。若问题仍存在,可能是模块名称与pip包名不一致,请手动安装正确的包。
Q: 如何添加新的Python环境?
A: 将完整的Python环境目录复制到程序的python文件夹中,程序会自动识别。环境目录名建议包含版本和位数信息,如”python_3.10.0x64”。
Q: 程序支持哪些操作系统?
A: 程序支持Windows系统。
程序使用环境及相关说明
1、适用的系统环境说明: win7及以上64位win操作系统 , 注意事项:win32位系统以及mac系统需要额外定制开发
2、关于使用限制:①无需注册、登录等限制,直接使用, ②没有电脑台数限制, ③无使用时间限制、不联网本地使用、确保数据安全
3、程序如何安装:不需要安装,按照说明使用即可。
特别注意:请先测试,注意备份原文件,之后再批量使用,避免不可逆损失。
程序使用说明
解压后的文件夹包含如下文件,双击运行程序即可,python文件夹名称不要修改,修改会出错识别不到环境
本工具下载地址
更新日志
V1.0



还没有评论,来说两句吧...