內容只提供Windows?10 與 Windows?11 下,搭建 Python?3.12 環境,并使用 Nuitka 將腳本打包為可執行文件的詳細流程。全文分為以下幾部分:
-
準備工作與系統要求
-
安裝 Python?3.12
-
配置環境變量與 pip
-
創建虛擬環境(推薦)
-
安裝編譯工具鏈
-
安裝 Nuitka 及相關依賴
-
編寫示例腳本
-
使用?Nuitka 打包
-
常見問題與排錯
-
附錄:常用命令匯總
1. 準備工作與系統要求
-
操作系統:Windows?10(1909+以上)或 Windows?11
-
權限:管理員權限(安裝編譯器、修改系統環境變量時需要)
-
網絡:能夠訪問 python.org 和 PyPI 源
2. 安裝 Python?3.12
-
下載安裝包
-
訪問官網:Python Releases for Windows | Python.org
-
選擇 Windows?installer (64-bit) for Python?3.12.x MSI 安裝包
-
-
運行 MSI 安裝程序
-
勾選 “Add Python 3.12 to PATH”
-
選擇 “Customize installation” → 勾選 pip、tcl/tk、文檔等 → “Next”
-
勾選 “Install for all users”(若有管理員權限)
-
安裝完成后,彈出提示 “Setup was successful”
-
-
驗證安裝
python --version # 應輸出:Python 3.12.x pip --version
3. 配置環境變量與 pip
-
PATH 自動配置:如安裝時已勾選,PATH 中應包含
C:\Program Files\Python312\
及...Scripts\
-
更新 pip、setuptools、wheel
python -m pip install --upgrade pip setuptools wheel
4. 創建虛擬環境(推薦)
在項目根目錄下執行:
python -m venv venv
激活虛擬環境:
-
PowerShell:
.\venv\Scripts\Activate.ps1
-
CMD:
.\venv\Scripts\activate.bat
激活后,命令行提示符前會出現 (venv)
。
5. 安裝編譯工具鏈
Nuitka 在 Windows 上默認使用 MSVC(Visual?Studio Build Tools),也可選用 MinGW。
5.1 MSVC(推薦)
-
下載并安裝 Visual?Studio Build Tools 2022
-
勾選 “C++ build tools” 工作負載,確保包含 “Windows 10 SDK”
安裝完成后,打開 “x64 Native Tools Command Prompt for VS?2022” 或在 PowerShell/CMD 預先運行:
call "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"
5.2 MinGW(可選)
-
安裝 mingw-w64
-
將 MinGW 的
bin
目錄加入 PATH,例如C:\mingw-w64\mingw64\bin
6. 安裝 Nuitka 及相關依賴
確保虛擬環境已激活,然后:
pip install nuitka
# 若需要 GUI 支持,需安裝 pillow、tkinter 等
# pip install pillow
檢查安裝:
python -c "import nuitka; print(nuitka.__version__)"
7. 編寫示例腳本
在項目目錄中新建 hello.py
,內容如下:
def main():print("Hello, Nuitka 打包!")if __name__ == "__main__":main()
8. 使用?Nuitka 打包
下面以幾種常用方式示例:
8.1 簡單編譯
nuitka --standalone --mingw64 hello.py
-
--standalone
:生成獨立目錄,可跨機器運行 -
--mingw64
:指定使用 MinGW 編譯(若使用 MSVC 可省略此參數)
完成后,會在當前目錄生成 hello.dist\
,其中包含可執行文件 hello.exe
及所需 DLL。
8.2 生成單文件
nuitka --onefile --standalone hello.py
-
--onefile
:將所有文件打包成一個 exe -
注意:單文件模式下首次啟動會有解包延遲
8.3 禁用控制臺窗口(GUI 程序)
nuitka --onefile --windows-disable-console gui_app.py
8.4 進階選項
-
--enable-plugin=tk-inter
:支持 Tkinter -
--enable-plugin=brotli
:支持 Brotli 壓縮 -
--lto=yes
:啟用鏈接時優化 -
--nofollow-import-to=<module>
:排除某些模塊
可通過 nuitka --help
查看完整參數列表。
9. 常見問題與排錯
問題 | 解決辦法 |
---|---|
“Visual?C++ build tools not found” | 需安裝 Visual?Studio Build Tools,并運行 vcvars64.bat。 |
打包后運行缺少 | 確保使用 |
單文件模式運行卡頓 | 可嘗試移除 |
打包 GUI 應用無界面 | 使用 |
10. 附錄:常用命令匯總
# 更新工具
python -m pip install --upgrade pip setuptools wheel# 創建并激活 venv
python -m venv venv
.\venv\Scripts\activate.bat # CMD
.\venv\Scripts\Activate.ps1 # PowerShell# 安裝 Nuitka
pip install nuitka# MSVC 環境配置(示例路徑)
call "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"# 基礎打包
nuitka --standalone hello.py# 單文件
nuitka --onefile --standalone hello.py# 禁用控制臺
nuitka --onefile --windows-disable-console gui_app.py# 啟用 LTO
nuitka --standalone --lto=full app.py
最后,您已完成在 Windows?10/11 上搭建 Python?3.12 環境,并了解使用 Nuitka 進行打包的相關流程。根據項目需求,可在此基礎上添加更多插件及自定義編譯選項。