pyinstaller 常用命令参数

    PyInstaller是一个用于将Python程序打包成独立的可执行文件的工具。它可以将Python代码和所有依赖的库、资源文件等打包成一个单独的可执行文件，方便在不安装Python解释器的环境中运行。PyInstaller提供了许多参数，用于配置打包过程和生成的可执行文件的行为。

常用参数列表

以下是PyInstaller命令的常用参数列表：

•-h 或 --help：显示帮助信息，列出所有可用参数及其说明。

•-D：生成一个目录，包含可执行文件和所有依赖的库文件。这是默认的打包方式。

•-F：生成一个单个的可执行文件，包含所有依赖的库文件。这个文件比较大，但更方便分发。

•-c：生成一个控制台应用程序，可以在命令行中运行。

•-w：生成一个窗口应用程序，没有控制台窗口。

•-i <图标文件>：指定生成的可执行文件的图标。

•-n <程序名>：指定生成的可执行文件的文件名。

•-p <路径>：添加额外的模块搜索路径。

•-r <资源文件>：将指定的文件或目录添加为资源文件，可以在程序运行时访问。

•--add-data <源路径>:<目标路径>：将源路径下的文件或目录添加为资源文件，可以在程序运行时访问。

•--hidden-import <模块名>：手动指定需要导入的模块，如果PyInstaller无法自动检测到。

•--clean：在打包之前清理之前生成的临时文件。

•--onefile：和-F参数相同，生成一个单个的可执行文件。

•--console：和-c参数相同，生成一个控制台应用程序。

•--windowed：和-w参数相同，生成一个窗口应用程序。

参数详解

-h 或 --help

这个参数用于显示帮助信息，列出所有可用参数及其说明。使用这个参数可以快速查看PyInstaller的命令行参数，了解每个参数的作用和用法。

-D

使用-D参数可以生成一个目录，其中包含可执行文件和所有依赖的库文件。这是PyInstaller的默认打包方式。生成的目录结构如下：

dist/

├── 可执行文件

└── 依赖的库文件

使用这种方式打包的好处是，可执行文件和库文件分离，可以方便地更新和替换库文件。但缺点是需要保持目录结构的完整性，不够方便分发。

-F

使用-F参数可以生成一个单个的可执行文件，其中包含所有依赖的库文件。这个文件比较大，但更方便分发。生成的文件结构如下：

dist/

└── 可执行文件

使用这种方式打包的好处是，所有文件都包含在一个文件中，方便分发和传输。但缺点是文件较大，更新和替换库文件不够方便。

-c

使用-c参数可以生成一个控制台应用程序，可以在命令行中运行。生成的可执行文件会打开一个控制台窗口，并在其中显示程序输出的内容。这种方式适用于需要与用户进行交互的命令行工具。

-w

使用-w参数可以生成一个窗口应用程序，没有控制台窗口。生成的可执行文件不会打开任何窗口，直接运行程序逻辑。这种方式适用于不需要与用户进行交互的GUI应用程序。

-i <图标文件>

使用-i参数可以指定生成的可执行文件的图标。通过指定一个图标文件，可以让生成的可执行文件在文件资源管理器中显示指定的图标。图标文件可以是ICO格式或者其他支持的图标格式。

-n <程序名>

使用-n参数可以指定生成的可执行文件的文件名。通过指定一个文件名，可以让生成的可执行文件使用指定的名称。默认情况下，PyInstaller会根据脚本文件的名称生成可执行文件的名称。

-p <路径>

使用-p参数可以添加额外的模块搜索路径。通过指定一个路径，可以告诉PyInstaller在指定的路径中搜索依赖的模块。这个参数可以用于解决PyInstaller无法自动检测到的模块依赖问题。

-r <资源文件>

使用-r参数可以将指定的文件或目录添加为资源文件，可以在程序运行时访问。通过指定一个资源文件，可以将文件或目录打包到生成的可执行文件中，程序可以在运行时访问这些资源。资源文件可以是任何类型的文件或目录。

--add-data <源路径>:<目标路径>

使用--add-data参数可以将指定的文件或目录添加为资源文件，可以在程序运行时访问。通过指定源路径和目标路径，可以将文件或目录打包到生成的可执行文件中，程序可以在运行时访问这些资源。源路径可以是一个文件或目录，目标路径是生成的可执行文件中的路径。

--hidden-import <模块名>

使用--hidden-import参数可以手动指定需要导入的模块，如果PyInstaller无法自动检测到。有时候，PyInstaller无法正确地检测到程序的依赖模块，导致打包后的可执行文件无法运行。通过使用--hidden-import参数，可以手动告诉PyInstaller需要导入的模块，解决这个问题。

--clean

使用--clean参数可以在打包之前清理之前生成的临时文件。PyInstaller在打包过程中会生成一些临时文件，使用这个参数可以删除这些临时文件，确保打包过程的干净。

--onefile

使用--onefile参数可以生成一个单个的可执行文件，和-F参数相同。这个参数只是-F参数的一个别名，可以使用其中任意一个参数来生成单个的可执行文件。

--console

使用--console参数可以生成一个控制台应用程序，和-c参数相同。这个参数只是-c参数的一个别名，可以使用其中任意一个参数来生成控制台应用程序。

--windowed

使用--windowed参数可以生成一个窗口应用程序，和-w参数相同。这个参数只是-w参数的一个别名，可以使用其中任意一个参数来生成窗口应用程序。

以上介绍的PyInstaller命令的常用参数，包括生成方式、应用类型、图标、文件名、模块搜索路径、资源文件、隐藏模块、清理临时文件等。通过了解这些参数，可以更好地使用PyInstaller工具，将Python程序打包成独立的可执行文件。祝你在使用PyInstaller时顺利！

常用的 Pyinstaller 运行参数有：

• -F 或 --onefile：生成单个可执行文件
• -D 或 --onedir：生成一个目录，包含可执行文件和依赖文件
• -n 或 --name：指定生成的可执行文件或目录的名称
• -w 或 --windowed：生成无控制台窗口的可执行文件（即 GUI 应用）
• -c 或 --console：生成控制台窗口的可执行文件（即命令行应用）
• --icon：指定应用程序图标文件的位置
• --hidden-import：指定需要手动添加的 Python 模块（如果 Pyinstaller 未正确解析引用）
• --additional-hooks-dir：指定一个目录，Pyinstaller 会在此目录中寻找自定义的 hook 文件，以添加额外的模块

这些参数可以在命令行中直接使用，例如在 Windows 系统下：

pyinstaller -F -w my_script.py

其中 -F 和 -w 分别生成单个可执行文件和无控制台窗口的应用程序。my_script.py 是待编译的 Python 脚本。

如果需要指定更多参数，可以将它们放在命令行中，例如：

pyinstaller -F -w --icon=my_icon.ico --name=my_app my_script.py

这将生成单个可执行文件，无控制台窗口，并指定应用程序图标和名称。

使用-w参数要当心，可能会让你崩溃。