python嵌入式打包即embed版安装使用

07-06 1019阅读

一、下载安装

官网直接下载对应的embed版本的文件包,解压即可。官网。我这里把解释器python-3115-embed-amd64​和代码program文件夹放在同一层级,文件目录如下,后面的路径也以此为准。

python嵌入式打包即embed版安装使用

二、库加载索引修改

在解压的python环境文件夹里找到python311._pth(因为我下的是3.11.5版本,因此此处是python311,不同版本的名称后面数字不同),修改内容:将import 前面的# 去掉。完成之后,便于运行中检索到该环境。

# Uncomment to run site.main() automatically
#import site
修改为:
# Uncomment to run site.main() automatically
import site

三、安装pip

下载get-pip.py​在python环境文件夹内和python.exe​在同一个文件夹内。

进入该文件夹,如我的解压路径为D:\python_program\python-3115-embed-amd64​,则进入该文件夹,在文件夹路径处输入cmd,即可打开cmd,并运行以下命令:

.\python.exe get-pip.py

会生成两个文件夹Lib和Scripts。

四、配置pip阿里源

在python环境文件夹:D:\python_program\python-3115-embed-amd64​,新建一个pip.ini文件,内容输入:

[global]
index-url = http://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host=mirrors.aliyun.com

五、添加环境变量(可选)

这里是个可选操作,可加也可不加。加入环境变量可以减少后面pip时路径带入。这里要注意的是,如果本身配置有其他python环境,可能会带来干扰,先把本机的python环境变量去掉。

在环境变量path里增加三个路径:D:\python_program\python-3115-embed-amd64​,D:\python_program\python-3115-embed-amd64\Lib\site-packages​,D:\python_program\python-3115-embed-amd64\Scripts​。

六、安装依赖包

我们需要安装依赖时,必须用嵌入式的解释器进行安装,下面是个安装pandas的范列:

.\python-3115-embed-amd64\python.exe -m pip install pandas -t .\python-3115-embed-amd64\Lib\site-packages
注意:

6.1 解释器必须是嵌入式解释器.\python-3115-embed-amd64\python.exe,同时通过-t参数来指定三方库的位置,也就是说,必须安装到项目的目录中,而不是系统的默认开发环境目录。如果前面配置了是嵌入式解释器的环境变量,解释器就不用再输入路径,可以简化命令长度。

6.2 embed版的python过于精简,可能tar包也无法安装,可以下载wheel格式的直接安装。一个查找wheel的网址:piwheels - Package List

七、安装Tkinter

从标准版安装包中解析出Tkinter文件并放入合适部位。我安装的是python3.11.5,因此下载python-3.11.5的exe安装包,用UniExtract进行解包,第一层解包到tcltk.msi文件,再对tcltk.msi继续解析,得到Lib、tcl、Dlls和libs四个文件包。把Lib中的三个文件夹:idlelib、tkinter和turtledemo放入D:\python_program\python-3115-embed-amd64\Lib\site-packages​中,tcl、Dlls和libs三个文件夹放入D:\python_program\python-3115-embed-amd64​中。并修改python311._pth文件,加入四个文件的位置索引。

python311.zip
.
#下面四个是tk的引入包放置位置,从python安装包里拆出来的,Lib中idlelib、tkinter和turtledemo放置在site-packages里
Lib/site-packages
DLLs
libs
tcl
# Uncomment to run site.main() automatically
import site

八、导入自定义模块

试了网上的很多种代码方案都没成功,忽然想到其本身就一个索引文件路径,将自定义模块的路径引入即可,省去了各种写代码等,下面是完整版的pth文件内容,第八行是导入自定义模块。

python311.zip
.
#下面四个是tk的引入包放置位置,从python安装包里拆出来的,Lib中idlelib、tkinter和turtledemo放置在site-packages里
Lib/site-packages
DLLs
libs
tcl
../program#自定义模块路径,这里用了..表示program文件夹与解释器所在的python-3115-embed-amd64同级。
# Uncomment to run site.main() automatically
import site

九、编写启动脚本

@echo off
chcp 65001
echo 开始运行
.\python-3115-embed-amd64\python.exe      .\program\test.py
pause

这里chcp命令用来声明编码,防止中文提示乱码。

注意解释器必须使用项目内置的嵌入式解释器.\python-3115-embed-amd64\python.exe​

十、搭建过程中出现的问题:

10.1 本地环境变量的干扰

本地装有python环境,在第一次进行依赖包安装时总是出现异常报错,删掉本地环境配置后出错减少。重要的是一定要用嵌入式解释器.\python-3115-embed-amd64\python.exe​来进行安装运行等,否则环境干扰会混乱。

10.2 tar格式依赖包报错。

安装tar格式依赖包时总是出错无法安装,可以直接网上查找相关的wheel包进行本地化安装。

10.3 图片相对路径读取失败。

用相对路径的图片在IDE中会正常识别,但在这里会报路径错误,要注意路径的层次。

比如我的图片是放在\program\​下的,与运行的代码py在同一文件夹,在IDE中路径为同一层级,均为当前路径,可以直接文件名引用,但在embed中运行时,因为主路径为python_program​为起点,因此图片路径需要加入上级文件路径,和运行py文件的路径方式一致,路径为:.\program\xxx.png​。

我的文件结构为:

D:\python_program

-program

-python-3115-embed-amd64

10.4 默认保存文件的路径

默认保存文件在bat运行相对路径的起点,比如我默认保存的excel文件出现在python_program内。

10.5 VScode中模块导入失败

两种处理方法:

10.5.1 代码顶部动态地将当前工作目录添加到 sys.path 中。
import sys
import os
sys.path.append(os.getcwd())
10.5.2 修改 VSCode 的 settings.json 文件,设定当前解释器的环境变量

通过VSCode 的 settings.json设置了 PYTHONPATH 环境变量,确保了我的项目路径 my_project 被加入到模块搜索路径中。

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python 调试程序: 当前文件",
            "type": "debugpy",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal"
        }
// PYTHONPATH 环境变量
        {
    "terminal.integrated.env.windows":
		 {"PYTHONPATH": "/python_program"},
    "terminal.integrated.env.linux":
		 {"PYTHONPATH": "/path/to/your/project"},
    "terminal.integrated.env.osx":
		 {"PYTHONPATH": "/path/to/your/project"}
		}
    ]
}

原文发布于:https://www.tndyx.cc/docs/程序代码/python/2024-03-30python嵌入式打包即embed版安装使用/

参考:

一键整合,万用万灵,Python3.10项目嵌入式一键整合包的制作(Embed)_python 整合包怎么做-CSDN博客

Python安装包–embedded版本安装及pip配置_python_embeded-CSDN博客

制作轻量级Python环境指南(包含在Python Embeddable版本中增加Tkinter:Tk支持) - 知乎 (zhihu.com)

Python打包,嵌入式方式打包,而且是官方推荐的打包方式-Python嵌入式打包真的不如pyinstaller吗?_python嵌入版-CSDN博客

从根本上优雅地解决 VSCode 中的 Python 模块导入问题-CSDN博客

VPS购买请点击我

文章版权声明:除非注明,否则均为主机测评原创文章,转载或复制请以超链接形式并注明出处。

目录[+]