vue项目打包

一、终端运行命令 npm run build

二、打包成功的标志与项目的改变，如下图：





3、点击index.html，通过浏览器运行，出现以下报错，如图：



四、那么应该如何修改呢？

具体步骤如下：

1、查看package.js文件的scripts命令

2、打开webpack.dev.conf.js文件，找到publicPath: config.dev.assetsPublicPath,按Ctrl点击，跳转到index.js文件

3、其中dev是开发环境，build是构建版本，找到build下面的assetsPublicPath: '/',然后修改为assetsPublicPath: './',即“/”前加点。

4、终端运行 npm run build 即可。

此时点击index.html，通过浏览器运行便，会发现动态绑定的static的图片找不到，故static必须使用绝对路径。将图片路径修改为绝对路径，至此，打包完成。

五、温馨提示

更多博文，请关注：xssy5431 【小拾岁月】

扫码：



 

1.安装

https://pypi.org/project/PyInstaller/

pip install PyInstaller

2.文档

https://pyinstaller.readthedocs.io/en/stable/

3.使用

pyinstaller -F -w filepath

参数F：打包为一个exe，不加生成文件夹

参数w：后台运行，不加前台运行（会有黑窗口）

参数filepath：需要打包的Python文件路径

执行命令后会生成两个文件夹build、dist，双击dist目录下的exe就能后台运行了。

pyinstaller会自动添加依赖，举例说明：

项目目录结构如下：

main.py

inputview.py

find.py

listview.py

其调用关系是 main.py-->inputview.py-->find.py-->listview.py

此时，只需要打包main.py即可，其他依赖会自动添加至exe。

4.打包图标

ico图标生成：http://www.ico51.cn/

a.准备ico图标（注：不能简单修改后缀，否则报错，最后两个参数为文件路径）

b.命令：pyinstaller -F -w -i config.ico QQ.py

5.高级用法

运行命令： pyinstaller filepath 后，会在当前目录下生成.spec文件，可对该文件进行配置，实现定制化打包。

a.需求：主程序导入了配置文件config.py，打包默认将所有依赖添加至exe，但config.py后续要求是可配置的，不应该一起打包，此实现如下：

pyinstaller filepath 生成.spec文件

编辑修改.spec 添加排除规则 excludes=['config']

重新打包 pyinstaller filepath

将config.py复制至dist目录，整个dist目录就是打包好的可配置运行环境，运行dist中的exe，即可运行。

 

 

 

      目前python打包工具有多个，目前比较好用的为pyinstaller，该工具可以支持在window和linux下使用。

      在windows下，大小为几十K的源文件打包成exe文件，可能为几十兆，原因是把程序所引用的库文件也一起打包在一起。

      如下以windows系统为例，分2个步骤，演示如何使用pyinstaller打包。

      第1步：安装pyinstaller

      安装pyinstaller之前首先必须有pip，如果还没有安装，请用度娘搜索“python安装pip”，资源丰富，在此不再介绍，使用pip安装pyinstaller的命令如下：

pip install pyinstaller

      命令执行的截图如下，直至安装完毕，我仅截取了前面部分打印信息。



      第2步：打包exe文件

      如果是打包一个py文件，可以使用“pyinstaller -F 待打包文件名”进行打包，在命令执行完毕后，会在dist目录下生成一个“待打包文件名.exe”的文件。如果不使用“-F”参数，则会在dist目录下生成一个“待打包文件名”的文件夹，该文件夹下包含“待打包文件.exe”，但是要整个文件夹在一起才能正常工作，因为这个文件夹的功能相当于使用“-F”时的一个“待打包文件.exe”。

      使用加F参数打包成一个exe文件的操作截图如下：



       使用“F”强制打包参数，有时会导致软件功能运行不正常，仅限于小的范例使用，如果项目有多个py文件，则建议别再使用“F”参数。

      如果项目有多个文件，打包时可以把多个文件列出来，中间用空格隔开即可。

      如果需要修改默认图标为指定图标，则使用“-i  图标文件名”来实现。

      如下为使用多个py文件和图标的打包截图。



      pyinstaller的参数见下表，大家可以在需要时参考。

参数
			
参数全称
			
参数说明
		

			
-F
			
			

			
–onefile
			
			

			
打包成单个可执行文件，如果你的代码都写在一个.py文件，则可以使用，如果是多个.py文件，建议不要使用。
			
		

			
-D
			
			

			
–onedir
			
			

			
打包多个文件，在dist中生成很多依赖文件，适合以框架形式编写工具代码，该方式代码较易于维护。
			
		
-K
			
–tk
			
在部署时包含 TCL/TK。
		
-a
			
–ascii
			
不包含编码.在支持Unicode的python版本上默认包含所有的编码。
		
-d
			
–debug
			

			
产生debug版本的可执行文件
			
		
-w
			
–windowed,–noconsole
			
使用Windows子系统执行.当程序启动的时候不会打开命令行(仅对Windows有效)
		
-c
			
–nowindowed,–console
			

			
使用控制台子系统执行(默认)(只对Windows有效)

			
pyinstaller -c  xxxx.py

			
pyinstaller xxxx.py --console
			
		
-s
			
–strip
			

			
可执行文件和共享库将run through strip。

			
注意Cygwin的strip可能使普通的win32 Dll无法使用
			
		
-X
			
–upx
			
如果有UPX安装(执行Configure.py时检测)，则会压缩执行文件(Windows系统中的DLL也会)
		
-o DIR
			
–out=DIR
			
指定spec文件的生成目录,如果没有指定,而且当前目录是PyInstaller的根目录,会自动创建一个用于输出(spec和生成的可执行文件)的目录.如果没有指定,而当前目录不是PyInstaller的根目录,则会输出到当前的目录下。
		
-p DIR
			
–path=DIR
			

			
设置导入路径(和使用PYTHONPATH效果相似)。

			
可以用路径分割符(Windows使用分号，Linux使用冒号)分割,指定多个目录.也可以使用多个-p参数来设置多个导入路径，让pyinstaller自己去找程序需要的资源
			
		
-i <FILE.ICO>
			
–icon=<FILE.ICO>
			
将file.ico添加为可执行文件的资源(只对Windows系统有效)，改变程序的图标  pyinstaller -i  ico路径 xxxxx.py
		
–i <FILE.EXE, N>
			
–icon=<FILE.EXE, N>
			

			
将file.exe的第n个图标添加为可执行文件的资源(只对Windows系统有效)
			
		
-v FILE
			
–version=FILE
			
将verfile作为可执行文件的版本资源(只对Windows系统有效)
		
-n NAME
			
–name=NAME
			

			
可选的项目(产生的spec的)名字.如果省略，第一个脚本的主文件名将作为spec的名字
			
		
 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

如果你喜欢这篇文章，别忘了点赞和评论哦！

使用Pyinstaller打包Python项目包含了大量的坑，这篇文章总结实践得到的Pyinstaller打包经验。本文的例子为Python3.6代码，Pyinstaller3.4，在windows下打包为64位和32位版本。

目录

Pyinstaller基本使用方法

Python项目的打包方法

1.spec文件生成

2.spec文件配置

3.使用spec执行打包命令

Visual C++ run-time .dlls包含

Python模块的打包问题

冻结打包路径

其它问题

Pyinstaller基本使用方法

Python项目的打包方法

1.spec文件生成

2.spec文件配置

3.使用spec执行打包命令

Python模块的打包问题

冻结打包路径

其它问题

Pyinstaller基本使用方法

Pyinstaller可以通过简单的命令进行python代码的打包工作，其基本的命令为：

pyinstaller -option xxx.py

options的详情可参考官方帮助文档https://pyinstaller.readthedocs.io/en/stable/usage.html

这边只介绍用到的option：-d生成一个文件目录包含可执行文件和相关动态链接库和资源文件等；-f仅生成一个可执行文件

-D, --onedir
			
Create a one-folder bundle containing an executable (default)
		
-F, --onefile
			
Create a one-file bundled executable.
		
对于打包结果较大的项目，选用-d生成目录相比单可执行文件的打包方式，执行速度更快，但包含更加多的文件。本文的例子选中-D方式打包。

Python项目的打包方法

以一个多文件和目录的Python项目为例，项目文件包含：1.Python源代码文件；2.图标资源文件；3.其它资源文件

以图中项目为例，Python源代码文件在多个目录下：bin, lib\app, lib\models, lib\views；图标资源文件在lib\icon目录下；其它资源文件在data目录下，包括文本文件，视频文件等等。



1.spec文件生成

为了进行自定义配置的打包，首先需要编写打包的配置文件.spec文件。当使用pyinstaller -d xxx.py时候会生成默认的xxx.spec文件进行默认的打包配置。通过配置spec脚本，并执行pyinstaller -d xxx.spec完成自定义的打包。

通过生成spec文件的命令，针对代码的主程序文件生成打包对应的spec文件

 pyi-makespec -w xxx.py

打开生成的spec文件，修改其默认脚本，完成自定义打包需要的配置。spec文件是一个python脚本，其默认的结构如下例所示

# -*- mode: python -*-

block_cipher = None


a = Analysis(['fastplot.py'],
             pathex=['D:\\install_test\\DAGUI-0.1\\bin'],
             binaries=[],
             datas=[],
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher)
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          exclude_binaries=True,
          name='fastplot',
          debug=False,
          strip=False,
          upx=True,
          console=False )
coll = COLLECT(exe,
               a.binaries,
               a.zipfiles,
               a.datas,
               strip=False,
               upx=True,
               name='fastplot')

spec文件中主要包含4个class: Analysis, PYZ, EXE和COLLECT.


	
Analysis以py文件为输入，它会分析py文件的依赖模块，并生成相应的信息
	
	

	
PYZ是一个.pyz的压缩包，包含程序运行需要的所有依赖
	
	

	
EXE根据上面两项生成
	
	

	
COLLECT生成其他部分的输出文件夹，COLLECT也可以没有
	
2.spec文件配置

首先给出举例python项目的spec文件配置

# -*- mode: python -*-
import sys
import os.path as osp
sys.setrecursionlimit(5000)

block_cipher = None


SETUP_DIR = 'D:\\install_test\\FASTPLOT\\'

a = Analysis(['fastplot.py',
              'frozen_dir.py',
              'D:\\install_test\\FASTPLOT\\lib\\app\\start.py',
             'D:\\install_test\\FASTPLOT\\lib\\models\\analysis_model.py',
             'D:\\install_test\\FASTPLOT\\lib\\models\\datafile_model.py',
             'D:\\install_test\\FASTPLOT\\lib\\models\\data_model.py',
             'D:\\install_test\\FASTPLOT\\lib\\models\\figure_model.py',
             'D:\\install_test\\FASTPLOT\\lib\\models\\time_model.py',
             'D:\\install_test\\FASTPLOT\\lib\\models\\mathematics_model.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\constant.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\custom_dialog.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\data_dict_window.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\data_process_window.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\data_sift_window.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\mathematics_window.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\para_temp_window.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\mainwindow.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\paralist_window.py',
             'D:\\install_test\\FASTPLOT\\lib\\views\\plot_window.py'],
             pathex=['D:\\install_test\\FASTPLOT'],
             binaries=[],
             datas=[(SETUP_DIR+'lib\\icon','lib\\icon'),(SETUP_DIR+'data','data')],
             hiddenimports=['pandas','pandas._libs','pandas._libs.tslibs.np_datetime','pandas._libs.tslibs.timedeltas',
             'pandas._libs.tslibs.nattype', 'pandas._libs.skiplist','scipy._lib','scipy._lib.messagestream'],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher)
                                     
            
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          exclude_binaries=True,
          name='fastplot',
          debug=False,
          strip=False,
          upx=True,
          console=True)
coll = COLLECT(exe,
               a.binaries,
               a.zipfiles,
               a.datas,
               strip=False,
               upx=True,
               name='fastplot')


a) py文件打包配置

针对多目录多文件的python项目，打包时候需要将所有相关的py文件输入到Analysis类里。Analysis类中的pathex定义了打包的主目录，对于在此目录下的py文件可以只写文件名不写路径。如上的spec脚本，将所有项目中的py文件路径以列表形式写入Analysis，这里为了说明混合使用了绝对路径和相对路径。

b) 资源文件打包配置

资源文件包括打包的python项目使用的相关文件，如图标文件，文本文件等。对于此类资源文件的打包需要设置Analysis的datas，如例子所示datas接收元组：datas=[(SETUP_DIR+'lib\\icon','lib\\icon'),(SETUP_DIR+'data','data')]。元组的组成为(原项目中资源文件路径，打包后路径)，例子中的(SETUP_DIR+'lib\\icon','lib\\icon')表示从D:\\install_test\\FASTPLOT\\lib\\icon下的图标文件打包后放入打包结果路径下的lib\\icon目录。

c)Hidden import配置

pyinstaller在进行打包时，会解析打包的python文件，自动寻找py源文件的依赖模块。但是pyinstaller解析模块时可能会遗漏某些模块（not visible to the analysis phase），造成打包后执行程序时出现类似No Module named xxx。这时我们就需要在Analysis下hiddenimports中加入遗漏的模块，如例子中所示。

d)递归深度设置

在打包导入某些模块时，常会出现"RecursionError: maximum recursion depth exceeded"的错误，这可能是打包时出现了大量的递归超出了python预设的递归深度。因此需要在spec文件上添加递归深度的设置，设置一个足够大的值来保证打包的进行，即

import sys
sys.setrecursionlimit(5000)


e)去除不必要的模块import

有时需要让pyinstaller不打包某些用不到的模块，可通过在excludes=[]中添加此模块实现，如

excludes=['zmq']

3.使用spec执行打包命令

pyinstaller -D xxx.spec

打包生成两个文件目录build和dist，build为临时文件目录完成打包后可以删除；dist中存放打包的结果，可执行文件和其它程序运行的关联文件都在这个目录下。



Visual C++ run-time .dlls包含

针对在Windows<10发布使用，且Python>=3.5的情况，Pyinstaller打包的程序可能会出现不包含Visual C++ run-time .dlls的情况，Python>=3.5需要使用Visual Studio 2015 run-time，也就是Universal CRT，这些runtime在Win10本身或Win7到Win8.1版本的更新包里，但程序打包后使用的系统里并不一定安装了。因此需要参考Universal CRT的建议，应用以下的方法解决这个问题：


	
Build on Windows 7 which has been reported to work.
	
	

	
Include one of the VCRedist packages (the redistributable package files) into your application’s installer. This is Microsoft’s recommended way, see “Distributing Software that uses the Universal CRT“ in the above-mentioned link, numbers 2 and 3.
	
	

	
Install the Windows Software Development Kit (SDK) for Windows 10 and expand the .spec-file to include the required DLLs, see “Distributing Software that uses the Universal CRT“ in the above-mentioned link, number 6.
	
 

Python模块的打包问题

程序调用的很多包，在打包时候可能会出现一些问题，针对这写问题需要做一些处理才能保证打包的程序正常执行。

1.PyQt plugins缺失

使用PyQt编写UI交互界面的python代码在进行打包时可能会出现一些特别的问题。

执行使用了PyQt的打包程序，常会出现这样的错误，提示缺少Qt platfrom plugin “windows”，如下图



打包后程序运行后，使用png格式的图标可以正常显示，但使用的ico格式图标不显示（对于所有图标和关联文件都无法使用的情况涉及到路径问题，后文会另外解释）。

这两个错误产生的问题都是因为打包时没有将PyQt相关的动态链接库目录生成到打包目录下，因此可以通过将这些需要的文件目录拷贝到打包生成目录下，解决plugin缺失问题。以使用PyQt5编写的python软件打包为例，完成打包后的结果目录下包含PyQt5文件夹，将PyQt5\Qt\plugins下的所有内容（如下图）拷贝到打包结果目录。这样就可以解决PyQt plugins缺失的问题。



2.动态链接库缺失问题

更一般的，打包后可能会缺失某些动态链接库，造成执行程序出错，如

ImportError: DLL load failed: 找不到指定的模块

在打包过程中一般会有与此相关的warning提示（lib not found）无法找到这些动态链接库。例如在32位版本的打包中，可能会出现scipy模块相关的dll文件无法找到。这时就需要在打包的spec文件中指定动态链接库路径，使其关联到打包后的路径中。

binaries=[('C:\\Program Files\\Python36-32\\Lib\\site-packages\\scipy\\extra-dll','.')]

Analysis下的binaries是为打包文件添加二进制文件，缺失的动态链接库可以通过这种方式自动加入到打包路径中。

3.窗体风格变化问题

在某些情况下，如在精简环境下的python程序打包中，执行打包后的程序会出现窗体风格变为老式的win风格，这是由于打包时候PyQt的styles动态库没有找到。因此只需要在Python 目录下找到 Lib\site-packages\PyQt5\Qt\plugins\styles，将styles整个目录复制到打包结果目录。

4.UnicodeDecodeError

当打包时出现类似错误时：

UnicodeDecodeError: 'utf-8' codec can't decode byte 0xce in position 122

可在打包的命令行中输入chcp 65001设置命令行显示utf-8字符，然后再执行打包命令。或者，修改pyinstaller包下的compat.py，根据报错对应的行将

out = out.decode(encoding)

改为

out = out.decode(encoding, 'replace')

冻结打包路径

执行打包后的程序，经常会出现程序使用的图标无法显示，程序使用的关联文件无法关联。或者，在打包的本机上运行正常，但是将打包后的程序放到其它机器上就有问题。这些现象都很有可能是由程序使用的文件路径发生改变产生的，因此在打包时候我们需要根据执行路径进行路径“冻结”。

1.使用绝对路径

在python代码中使用绝对路径调用外部文件可以保证打包时候路径可追溯，因此在本机上运行打包后程序基本没问题。但是当本机上对应路径的资源文件被改变，或者将打包程序应用到别的机器，都会出现搜索不到资源文件的问题。这种方式不是合适的打包发布python软件的方式。

2.使用冻结路径

增加一个py文件，例如叫frozen_dir.py

# -*- coding: utf-8 -*-
"""
Created on Sat Aug 25 22:41:09 2018
frozen dir
@author: yanhua
"""
import sys
import os

def app_path():
    """Returns the base application path."""
    if hasattr(sys, 'frozen'):
        # Handles PyInstaller
        return os.path.dirname(sys.executable)
    return os.path.dirname(__file__)

其中的app_path()函数返回一个程序的执行路径，为了方便我们将此文件放在项目文件的根目录，通过这种方式建立了相对路径的关系。

源代码中使用路径时，以app_path()的返回值作为基准路径，其它路径都是其相对路径。以本文中使用的python项目打包为例，如下所示

import frozen_dir
SETUP_DIR = frozen_dir.app_path()

FONT_MSYH = matplotlib.font_manager.FontProperties(
                fname = SETUP_DIR + r'\data\fonts\msyh.ttf',
                size = 8)

DIR_HELP_DOC = SETUP_DIR + r'\data\docs'
DIR_HELP_VIDEO = SETUP_DIR + r'\data\videos'

通过冻结路径，使用了基准目录下的data目录下的fonts, docs, videos。

主程序中也做了类似的调整，改变其设置路径方法

import frozen_dir

SETUP_DIR = frozen_dir.app_path()+r'\lib'
sys.path.append(SETUP_DIR)

使用这样的方法进行打包，打包后的可执行程序就可以在其它机器上运行。

其它问题

由于操作系统和运行环境的不同，pyinstaller打包中还可能遇到很多其它问题，最后总结一些我在打包中遇到的其它坑：

1.权限问题

通常时在打包时出现的某些文件拒绝访问或没有权限执行某些操作等。解决这个的方法一般有这几个方面：

a）使用管理员权限运行cmd或其它命令行窗口

b）关闭杀毒软件

c）使用完全权限的管理员账户

2.中文路径

pyinstaller打包后的路径使用中文没有问题，不过为了减少打包时候出错的可能，尽量将打包使用的资源文件和代码文件路径设置为英文。

3.打包后文件的大小

通常python打包为可执行文件都会得到一个较大的包，这是无法避免的，但是我们还是可以通过一些方法来尽量精简打包后的执行程序：

a）在代码中减少不必要的import，如from xxx import *

b）在精简的运行环境（如原生python环境）下打包，缺什么包就下什么包，避免不必要的python包被打包入程序。尤其是anaconda这样的集成环境下打包的结果会大很多。

c）使用UPX