4. 在Windows上使用 Python?

4.1.1. 安裝步驟?

四個 Python 3.12 安裝程序可供下載 - 32位和64位版本的各有兩個。 web installer （網(wǎng)絡(luò)安裝包）是一個小的初始化工具，它將在安裝過程中，根據(jù)需要自動下載所需的組件。 offline installer （離線安裝包）內(nèi)含默認(rèn)安裝所需的組件，可選擇功能仍需要Internet連接下載。請參閱 免下載安裝 以了解在安裝過程中避免下載的其他方法。

啟動安裝程序后，可以選擇以下兩個選項(xiàng)之一：

如果選擇“Install Now（立即安裝）”：

• 您 不 需要成為管理員（除非需要對C運(yùn)行庫進(jìn)行系統(tǒng)更新，或者為所有用戶安裝 適用于Windows的Python啟動器 ）

• Python將安裝到您的用戶目錄中

• 適用于Windows的Python啟動器 將根據(jù)第一頁底部的選項(xiàng)安裝

• 將安裝標(biāo)準(zhǔn)庫，測試套件，啟動器和pip

• 如果選擇將安裝目錄將添加到 PATH

• 快捷方式僅對當(dāng)前用戶可見

選擇“自定義安裝”將允許您選擇：要安裝的功能、安裝位置、其他選項(xiàng)或安裝后的操作。如果要安裝調(diào)試符號或二進(jìn)制文件，您需要使用此選項(xiàng)。

如要為全部用戶安裝，應(yīng)選擇“自定義安裝”。在這種情況下:

• 您可能需要提供管理憑據(jù)或批準(zhǔn)

• Python 將安裝到Program Files目錄中

• 適用于Windows的Python啟動器 將安裝到Windows目錄中

• 安裝期間可以選擇可選功能

• 標(biāo)準(zhǔn)庫可以預(yù)編譯為字節(jié)碼

• 如果選中，安裝目錄將添加到系統(tǒng) PATH

• 快捷方式所有用戶可用

4.1.2. 刪除 MAX_PATH 限制?

歷史上Windows的路徑長度限制為260個字符。這意味著長于此的路徑將無法解決并導(dǎo)致錯誤。

在最新版本的 Windows 中，此限制可被擴(kuò)展到大約 32,000 個字符。 但需要讓管理員激活“啟用 Win32 長路徑”組策略，或在注冊表鍵 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem 中設(shè)置 LongPathsEnabled 為 1。

這允許 open() 函數(shù)，os 模塊和大多數(shù)其他路徑功能接受并返回長度超過 260 個字符的路徑。

更改上述選項(xiàng)后，無需進(jìn)一步配置。

4.1.3. 無UI 安裝?

安裝程序UI中的所有選項(xiàng)也可以從命令行指定，允許腳本安裝程序在許多機(jī)器上復(fù)制安裝，而無需用戶交互。還可以在不禁用UI的情況下設(shè)置這些選項(xiàng)，以更改一些默認(rèn)值。

The following options (found by executing the installer with /?) can be passed into the installer:

所有其他選項(xiàng)都傳遞為 name=value ，其中值通常是 0 來禁用某個特性， 1 來啟用某個特性或路徑。可用選項(xiàng)的完整列表如下所示。

例如，要以靜默方式全局安裝默認(rèn)的Python，您可以（在命令提示符>）使用以下命令:

python-3.9.0.exe /quiet InstallAllUsers=1 PrependPath=1 Include_test=0

要允許用戶在沒有測試套件的情況下輕松安裝Python的個人副本，可以使用以下命令提供快捷方式。這將顯示一個簡化的初始頁面，不允許自定義:

python-3.9.0.exe InstallAllUsers=0 Include_launcher=0 Include_test=0
    SimpleInstall=1 SimpleInstallDescription="Just for me, no test suite."

（請注意，省略啟動器也會省略文件關(guān)聯(lián)，并且僅在全局安裝包含啟動器時才建議用于每用戶安裝。）

上面列出的選項(xiàng)也可以在一個名為 unattend.xml 的文件中與可執(zhí)行文件一起提供。此文件指定選項(xiàng)和值的列表。作為屬性提供的值，（如果可能）它將轉(zhuǎn)換為數(shù)字。作為文本提供的值，始終保留為字符串。此示例文件設(shè)置與上一示例采用相同的選項(xiàng)：

<Options>
    <Option Name="InstallAllUsers" Value="no" />
    <Option Name="Include_launcher" Value="0" />
    <Option Name="Include_test" Value="no" />
    <Option Name="SimpleInstall" Value="yes" />
    <Option Name="SimpleInstallDescription">Just for me, no test suite</Option>
</Options>

4.1.4. 免下載安裝?

由于下載的初始安裝包中未包含Python的某些可選功能，如果選擇安裝這些功能可能需要Internet連接。為了避免這種需要，可以按需下載所有可能的組件，以創(chuàng)建一個完整的布局，該布局將不再需要internet連接，而不管所選擇的特性是什么。請注意，此下載可能比要求的要大，但是如果要執(zhí)行大量安裝，則擁有本地緩存??的副本非常有用。

從命令提示符執(zhí)行以下命令以下載所有可能的必需文件。 請記得要將 python-3.9.0.exe 替換為安裝程序的實(shí)際名稱，并在單獨(dú)的目錄中創(chuàng)建子目錄以避免同名文件間的沖突。

python-3.9.0.exe /layout [optional target directory]

您也可以指定 /quiet 選項(xiàng)來隱藏進(jìn)度顯示。

4.1.5. 修改安裝?

安裝Python后，您可以通過Windows中的“程序和功能”工具添加或刪除功能。選擇Python條目并選擇“卸載/更改”以在維護(hù)模式下打開安裝程序。

“修改” 允許您通過修改復(fù)選框來添加或刪除功能 - 未更改的復(fù)選框?qū)⒉粫惭b或刪除任何內(nèi)容。在此模式下無法更改某些選項(xiàng)，例如安裝目錄；要修改這些，您需要完全刪除然后重新安裝Python。

“修復(fù)” 將使用當(dāng)前設(shè)置驗(yàn)證應(yīng)安裝的所有文件，并替換已刪除或修改的任何文件

“卸載” 將完全刪除Python，但 適用于Windows的Python啟動器 除外，它在“程序和功能”中有自己的條目。

4.2.1. 已知的問題?

由于Microsoft Store應(yīng)用程序的限制，Python腳本可能無法對共享位置（如 TEMP ）和注冊表進(jìn)行完全寫入訪問。相反，它將寫入私人副本。如果腳本必須修改共享位置，則需要安裝完整安裝程序。

有關(guān)此限制的技術(shù)原理的更多細(xì)節(jié)，請查詢 Microsoft 已打包完全可信應(yīng)用的文檔，當(dāng)前位于 docs.microsoft.com/en-us/windows/msix/desktop/desktop-to-uwp-behind-the-scenes

4.4.1. Python應(yīng)用程序?

用Python編寫的應(yīng)用程序并不一定要求用戶了解這一事實(shí)。在這種情況下，可以使用嵌入式發(fā)行版在安裝包中包含Python的私有版本。根據(jù)它應(yīng)該有多透明(或者相反，它應(yīng)該看起來有多專業(yè))，有兩個選項(xiàng)。

使用專門的可執(zhí)行文件作為啟動程序需要一些編碼，但為用戶提供了最透明的體驗(yàn)。使用定制的啟動器，沒有明顯的跡象表明程序是在Python上運(yùn)行的：圖標(biāo)可以定制，公司和版本信息可以指定，文件關(guān)聯(lián)可以正常運(yùn)行。在大多數(shù)情況下，自定義啟動程序應(yīng)該只需使用硬編碼的命令行就能調(diào)用 Py_Main

更簡單的方法是提供批處理文件或生成的快捷方式，使用所需的命令行參數(shù)直接調(diào)用 python.exe 或 pythonw.exe 。在這種情況下，應(yīng)用程序?qū)@示為Python而不是其實(shí)際名稱，并且用戶可能無法將其與其他正在運(yùn)行的Python進(jìn)程或文件關(guān)聯(lián)區(qū)分開來。

對于后一種方法，包應(yīng)該與Python可執(zhí)行文件一起作為目錄安裝，以確保它們在路徑上可用。使用專用的啟動器，包可以位于其他位置，因?yàn)樵趩討?yīng)用程序之前有機(jī)會指定搜索路徑。

4.4.2. 嵌入Python?

用本地代碼編寫的應(yīng)用程序通常需要某種形式的腳本語言，嵌入式Python發(fā)行版可以用于此目的。通常，應(yīng)用程序的大部分都是本機(jī)代碼，某些部分將調(diào)用 python.exe 或直接使用 python3.dll 。無論是哪種情況，將嵌入的發(fā)行版解壓縮到應(yīng)用程序安裝的子目錄中就足以提供可加載的Python解釋器。

與應(yīng)用程序使用一樣，包可以安裝到任何位置，因?yàn)樵诔跏蓟忉屍髦坝袡C(jī)會指定搜索路徑。否則，使用嵌入式發(fā)行版和常規(guī)安裝之間沒有根本區(qū)別。

4.6.1. 附錄：設(shè)置環(huán)境變量?

Windows允許在用戶級別和系統(tǒng)級別永久配置環(huán)境變量，或臨時在命令提示符中配置環(huán)境變量。

要臨時設(shè)置環(huán)境變量，請打開命令提示符并使用 set 命令：

C:\>set PATH=C:\Program Files\Python 3.9;%PATH%
C:\>set PYTHONPATH=%PYTHONPATH%;C:\My_python_lib
C:\>python

這些環(huán)境變量的更改將應(yīng)用??于在該控制臺中執(zhí)行的任何其他命令，并且，由該控制臺啟動的任何應(yīng)用程序都繼承設(shè)這些設(shè)置。

在百分號中包含的變量名將被現(xiàn)有值替換，允許在開始或結(jié)束時添加新值。通過將包含 python.exe 的目錄添加到開頭來修改 PATH 是確保啟動正確版本的Python的常用方法。

要永久修改默認(rèn)環(huán)境變量，請單擊“開始”并搜索“編輯環(huán)境變量”，或打開系統(tǒng)屬性的 高級系統(tǒng)設(shè)置 ，然后單擊 環(huán)境變量 按鈕。在此對話框中，您可以添加或修改用戶和系統(tǒng)變量。要更改系統(tǒng)變量，您需要對計算機(jī)進(jìn)行無限制訪問（即管理員權(quán)限）。

4.6.2. 查找Python可執(zhí)行文件?

除了使用自動創(chuàng)建的Python解釋器的開始菜單項(xiàng)之外，您可能還想在命令提示符下啟動Python。安裝程序有一個選項(xiàng)可以為您設(shè)置。

在安裝程序的第一頁上，可以選擇標(biāo)記為“將Python添加到環(huán)境變量”的選項(xiàng)，以使安裝程序?qū)惭b位置添加到 PATH 。還添加了 Scripts\ 文件夾的位置。這允許你輸入 python 來運(yùn)行解釋器，并且 pip 用于包安裝程序。因此，您還可以使用命令行選項(xiàng)執(zhí)行腳本，請參閱 命令行 文檔。

如果在安裝時未啟用此選項(xiàng)，則始終可以重新運(yùn)行安裝程序，選擇“修改”并啟用它?；蛘撸梢允褂?附錄：設(shè)置環(huán)境變量 的方法手動修改 PATH 。您需要將Python安裝目錄添加到 PATH 環(huán)境變量中，該內(nèi)容與其他條目用分號分隔。示例變量可能如下所示（假設(shè)前兩個條目已經(jīng)存在）:

C:\WINDOWS\system32;C:\WINDOWS;C:\Program Files\Python 3.9

4.8.1. 入門?

py

py -3.7

py -2

'py' is not recognized as an internal or external command,
operable program or batch file.

py --list

#! python
import sys
sys.stdout.write("hello from Python %s\n" % (sys.version,))

py hello.py

#! python3

4.8.2. Shebang Lines?

如果腳本文件的第一行以 #! 開頭，則稱為 "shebang" 行。Linux和其他類Unix操作系統(tǒng)都有對這些行的本機(jī)支持，它們通常在此類系統(tǒng)上用來指示應(yīng)該如何執(zhí)行腳本。這個啟動器允許在Windows上對Python腳本使用相同的工具，上面的示例演示了它們的使用。

為了允許Python腳本中的shebang行在Unix和Windows之間移植，該啟動器支持許多“虛擬”命令來指定要使用的解釋器。支持的虛擬命令是：

• /usr/bin/env python

• /usr/bin/python

• /usr/local/bin/python

• python

例如，如果腳本開始的第一行

#! /usr/bin/python

將找到并使用默認(rèn)的Python。因?yàn)樵赨nix上編寫的許多Python腳本已經(jīng)有了這一行，你應(yīng)該發(fā)現(xiàn)這些腳本可以由啟動器使用而無需修改。如果您在Windows上編寫一個新腳本，希望在Unix上有用，那么您應(yīng)該使用以 /usr 開頭的一個shebang行。

Any of the above virtual commands can be suffixed with an explicit version (either just the major version, or the major and minor version). Furthermore the 32-bit version can be requested by adding "-32" after the minor version. I.e. /usr/bin/python3.7-32 will request usage of the 32-bit python 3.7.

shebang line的 /usr/bin/env 形式還有一個特殊屬性。在尋找已安裝的Python解釋器之前，此表單將搜索可執(zhí)行文件 PATH 以獲取Python可執(zhí)行文件。這對應(yīng)于Unix中 env 程序的行為，該程序?qū)⒃?PATH 執(zhí)行搜索。

4.8.3. shebang lines 的參數(shù)?

shebang lines 還可以指定要傳遞給Python解釋器的其他選項(xiàng)。例如，如果你有一個shebang lines ：

#! /usr/bin/python -v

然后Python將以 -v 選項(xiàng)啟動

4.8.4. 自定義?

[defaults]
python=3.7

[defaults]
python=3
python3=3.7

4.8.5. 診斷?

If an environment variable PYLAUNCHER_DEBUG is set (to any value), the launcher will print diagnostic information to stderr (i.e. to the console). While this information manages to be simultaneously verbose and terse, it should allow you to see what versions of Python were located, why a particular version was chosen and the exact command-line used to execute the target Python. It is primarily intended for testing and debugging.

4.8.6. Dry Run?

If an environment variable PYLAUNCHER_DRYRUN is set (to any value), the launcher will output the command it would have run, but will not actually launch Python. This may be useful for tools that want to use the launcher to detect and then launch Python directly. Note that the command written to standard output is always encoded using UTF-8, and may not render correctly in the console.

4.8.7. Install on demand?

If an environment variable PYLAUNCHER_ALLOW_INSTALL is set (to any value), and the requested Python version is not installed but is available on the Microsoft Store, the launcher will attempt to install it. This may require user interaction to complete, and you may need to run the command again.

An additional PYLAUNCHER_ALWAYS_INSTALL variable causes the launcher to always try to install Python, even if it is detected. This is mainly intended for testing (and should be used with PYLAUNCHER_DRYRUN).

4.8.8. Return codes?

The following exit codes may be returned by the Python launcher. Unfortunately, there is no way to distinguish these from the exit code of Python itself.

The names of codes are as used in the sources, and are only for reference. There is no way to access or resolve them apart from reading this page. Entries are listed in alphabetical order of names.

4.10.1. PyWin32?

Mark Hammond 的 PyWin32 模塊是一組用于高級Windows特定支持的模塊。這包括以下實(shí)用程序：

• Component Object Model (COM)

• Win32 API 調(diào)用

• 注冊

• 事件日志

• Microsoft Foundation Classes (MFC) user interfaces

PythonWin 是PyWin32附帶的一個示例MFC應(yīng)用程序。它是一個內(nèi)置調(diào)試器的可嵌入IDE。

4.10.2. cx_Freeze?

cx_Freeze 是一個 distutils 的擴(kuò)展 (參見 擴(kuò)展 Distutils)，它將 Python 腳本包裝成可執(zhí)行的 Windows 程序 (*.exe 文件)。 完成此操作后，你就可以分發(fā)你的應(yīng)用程序而無需用戶安裝 Python。