Python脚本打包及开机自启动配置指南

一、将Python脚本打包为EXE文件

1. 安装PyInstaller

pip install pyinstall

---

2. 常用打包命令详解

基础打包（单文件模式）

pyinstaller -F your_script.py

• 参数说明：

  • -F：生成单个独立的EXE文件，适合分发。

  • your_script.py：目标Python脚本文件名。

隐藏控制台窗口（适用于GUI程序）

pyinstaller -F -w your_script.py

• 参数说明：

  • -w：不显示控制台窗口（隐藏黑框）。

自定义EXE图标

pyinstaller -F -w -i icon.ico your_script.py

• 参数说明：

  • -i icon.ico：指定ICO格式的图标文件（需提前准备）。

---

3. 高级参数示例

添加数据文件（如图片、配置文件）

pyinstaller -F --add-data "data/*;data/" your_script.py

• 参数说明：

  • --add-data "源路径;目标路径"：将外部文件嵌入EXE。

排除无用依赖（精简体积）

pyinstaller -F --exclude-module matplotlib your_script.py

---

4. 打包操作步骤

1. 打开脚本所在目录：

   • 在文件资源器中进入Python脚本所在的文件夹。

   • 按住 Shift + 右键，选择 “在此处打开命令窗口” 或 “打开PowerShell”。

2. 执行打包命令：

   pyinstaller -F -w -i icon.ico your_script.py

3. 获取生成的EXE文件：

   • 打包完成后，在 dist/ 文件夹中找到生成的 your_script.exe。

---

5. 常见问题

• 杀毒软件误报：部分安全软件可能误判EXE为病毒，需添加信任。

• 图标不生效：确保ICO文件为256x256像素，且路径正确。

• 依赖缺失：若运行时提示缺少模块，使用 --hidden-import 手动添加。

---

二、设置开机自启动

1. 创建启动脚本（BAT文件）

1. 新建文本文件，重命名为 startup.bat。

2. 编辑内容（替换路径和文件名）：

   @echo off
   cd /d "D:\Your\Target\Folder"
   start your_script.exe
   exit

   • 关键说明：

     • cd /d：切换到EXE所在目录，避免路径错误。

     • start your_script.exe：启动目标程序（需替换为实际文件名）。

---

2. 将BAT文件加入开机启动项

1. 按下 Win + R，输入 shell:startup，按回车。

2. 将 startup.bat 的快捷方式复制到打开的启动文件夹：

   • 右键BAT文件 → 创建快捷方式 → 剪切到 Startup 文件夹。

---

3. 验证开机自启动

1. 重启电脑，检查程序是否自动运行。

2. 排查问题：

   • 若未生效，手动运行BAT文件检查错误提示。

   • 检查EXE路径和文件名是否正确。

---

三、完整流程图解

                   +---------------------+
                   |   Python脚本打包     |
                   +----------+----------+
                              |
                              v
+-------------------+ 生成EXE +-------------------+
|  pyinstaller命令  +----------> dist/your_script.exe
+-------------------+         +-------------------+
                              |
                              v
                   +---------------------+
                   |  配置开机自启动      |
                   +----------+----------+
                              |
                              v
            +-----------------+-----------------+
            | 创建BAT文件 → 添加快捷方式到启动文件夹 |
            +-----------------+-----------------+
                              |
                              v
                        +-----------+
                        | 重启验证  |
                        +-----------+

---

四、附录：常用命令速查表

场景	命令
基础打包	pyinstaller -F your_script.py
隐藏控制台	pyinstaller -F -w your_script.py
自定义图标	pyinstaller -F -w -i icon.ico your_script.py
添加数据文件	pyinstaller -F --add-data "src/*;dest/" your_script.py
排除模块	pyinstaller -F --exclude-module unused_module your_script.py