一、開篇：Windows用戶的專屬配置指南

在上一篇文章中，我?guī)阃瓿闪薖ython的初步安裝。但光把Python裝上去還遠(yuǎn)遠(yuǎn)不夠——Windows作為Python開發(fā)的"非原生"平臺(tái)（Python誕生于Unix環(huán)境），有它自己的一套配置邏輯和常見坑點(diǎn)。這篇文章就是Windows用戶的專屬深度指南。

我會(huì)把Windows平臺(tái)上Python開發(fā)的各種配置細(xì)節(jié)、實(shí)用技巧、常見問題一網(wǎng)打盡。讀完這篇，你就能把Windows打造成一個(gè)順手的Python開發(fā)環(huán)境。

二、重新認(rèn)識(shí)Python在Windows上的安裝結(jié)構(gòu)

2.1 Python安裝目錄全解析

當(dāng)你把Python裝到 D:\Python312（或其他自定義路徑）后，來看看這個(gè)目錄里都有什么：

D:\Python312\
├── python.exe          ← 這是Python解釋器的主程序
├── pythonw.exe         ← 無控制臺(tái)窗口的Python解釋器（運(yùn)行GUI程序用）
├── Lib\                ← Python標(biāo)準(zhǔn)庫，所有自帶的模塊都在這里
│   ├── os.py           ← os模塊的源碼
│   ├── json.py         ← json模塊的源碼
│   └── site-packages\  ← 第三方庫的安裝目錄（pip安裝的包在這里）
├── Scripts\            ← 可執(zhí)行腳本目錄
│   ├── pip.exe         ← pip包管理工具
│   ├── pip3.exe
│   └── jupyter.exe     ← 如果安裝了jupyter
├── Doc\                ← Python官方文檔（如果安裝時(shí)勾選了）
├── include\            ← C頭文件（寫C擴(kuò)展時(shí)用）
├── libs\               ← C語言靜態(tài)庫
├── tcl\                ← Tcl/Tk GUI庫
└── Tools\              ← 一些實(shí)用工具腳本

了解這個(gè)結(jié)構(gòu)很有用。比如你以后想知道某個(gè)第三方庫裝到哪里了，去 Lib\site-packages\ 找就行。

2.2 python.exe vs pythonw.exe

Windows上有兩個(gè)解釋器程序：

• python.exe：運(yùn)行時(shí)會(huì)打開一個(gè)控制臺(tái)窗口，適合命令行腳本
• pythonw.exe：運(yùn)行時(shí)沒有控制臺(tái)窗口，適合GUI程序（比如用Tkinter寫的桌面應(yīng)用）

# test_gui.py - 用pythonw.exe運(yùn)行不會(huì)有黑窗口
import tkinter as tk
root = tk.Tk()
root.title("我的GUI程序")
tk.Label(root, text="Hello from Python!").pack()
root.mainloop()

如果你雙擊運(yùn)行上述腳本，用 pythonw.exe 就不會(huì)彈出一個(gè)黑黢黢的命令行窗口。

2.3 Python Launcher（py.exe）詳解

這是Windows平臺(tái)上獨(dú)有的好東西。在安裝Python時(shí)如果勾選了"py launcher"，你的系統(tǒng)里會(huì)多一個(gè) py.exe 命令。

py launcher的作用：讓你在一臺(tái)電腦上方便地管理和切換多個(gè)Python版本。

# 查看系統(tǒng)中安裝了哪些Python版本
py --list
# 可能的輸出：
# -3.12-64 *
# -3.11-64
# -3.9-32
# 星號(hào)(*)表示當(dāng)前默認(rèn)版本
# 用指定版本運(yùn)行腳本
py -3.12 hello.py    # 用Python 3.12運(yùn)行
py -3.11 hello.py    # 用Python 3.11運(yùn)行
py -3.9 hello.py     # 用Python 3.9運(yùn)行
# 用默認(rèn)的Python 3版本運(yùn)行
py -3 hello.py
# 啟動(dòng)指定版本的交互式環(huán)境
py -3.12

py.exe 的工作原理是：它安裝在 C:\Windows\ 目錄下（這個(gè)目錄在PATH中），運(yùn)行時(shí)會(huì)根據(jù)參數(shù)去查找已安裝的Python版本，然后調(diào)用對(duì)應(yīng)的 python.exe。

你可以為每個(gè)Python腳本指定它需要的Python版本。在腳本的第一行添加shebang：

#!python3.12
# 這個(gè)腳本強(qiáng)制使用Python 3.12運(yùn)行

import sys
print(f"當(dāng)前Python版本: {sys.version}")

py.exe 會(huì)讀取這個(gè)shebang并選擇正確的解釋器。

注意：py launcher只在Windows上有。Mac和Linux用的是 python3 命令或pyenv等工具。

三、PATH環(huán)境變量深度解析

3.1 PATH到底是干什么的

這是Windows新手最困惑的概念之一。讓我用大白話解釋：

當(dāng)你在命令行輸入 python 時(shí)，系統(tǒng)怎么知道去執(zhí)行 D:\Python312\python.exe 呢？答案就是PATH。

PATH是一個(gè)"查找路徑列表"。系統(tǒng)按順序逐個(gè)目錄查找你要執(zhí)行的程序，找到了就運(yùn)行，找不到就去下一個(gè)目錄找，所有目錄都找不到就報(bào)"不是內(nèi)部或外部命令"。

# 查看當(dāng)前PATH（在cmd中）
echo %PATH%
# 查看當(dāng)前PATH（在PowerShell中）
$env:PATH -split ';'
# 用Python查看PATH
python -c "import os; [print(p) for p in os.environ['PATH'].split(';') if p]"

PATH中每個(gè)目錄用分號(hào)(;)隔開。一個(gè)典型的PATH可能是：

C:\Windows\system32;C:\Windows;C:\Python312;C:\Python312\Scripts;...

3.2 PATH中關(guān)于Python的條目

一個(gè)完整配置的Windows Python環(huán)境，PATH中應(yīng)該有兩個(gè)條目：

1. D:\Python312 — 包含 python.exe，讓你能直接輸入 python
2. D:\Python312\Scripts — 包含 pip.exe、jupyter.exe 等腳本工具

# 驗(yàn)證PATH配置是否正確
where python    # 應(yīng)該顯示Python安裝路徑
where pip       # 應(yīng)該顯示Scripts路徑

如果這兩個(gè)命令都正常顯示路徑，說明PATH配置正確。

3.3 手動(dòng)配置PATH的正確步驟

如果你安裝時(shí)忘了勾選"Add Python to PATH"，或者想修改PATH，按以下步驟操作：

① 按 Win + R，輸入 sysdm.cpl，回車（快速打開系統(tǒng)屬性）

② 點(diǎn)擊"高級(jí)"選項(xiàng)卡→"環(huán)境變量"按鈕

③ 環(huán)境變量窗口分為上下兩部分：

• 上面是"用戶變量"：只對(duì)當(dāng)前用戶生效
• 下面是"系統(tǒng)變量"：對(duì)所有用戶生效

④ 選中"用戶變量"中的 Path，點(diǎn)擊"編輯"

⑤ 點(diǎn)擊"新建"，添加兩條記錄（按你自己的安裝路徑）：

D:\Python312
D:\Python312\Scripts

⑥ 用"上移"按鈕把這兩條移到靠前的位置（系統(tǒng)會(huì)按從上到下的順序查找）

⑦ 一路點(diǎn)"確定"關(guān)閉所有窗口

關(guān)鍵點(diǎn)：修改環(huán)境變量后，之前打開的命令行窗口不會(huì)生效。你需要關(guān)閉后重新打開命令行，或者重啟電腦。

3.4 PATH優(yōu)先級(jí)導(dǎo)致的問題

這是Windows上最經(jīng)典的Python坑：

場景：你先裝了Python 3.11（在 C:\Python311），后來又裝了Python 3.12（在 D:\Python312）?，F(xiàn)在你在命令行輸入 python，啟動(dòng)的是哪個(gè)版本？

答案是：PATH中排在前面的那個(gè)目錄里的python.exe。

# 檢查當(dāng)前python命令實(shí)際指向的文件
where python

解決方法：

• 調(diào)小PATH中條目的順序，把你需要用的版本放在前面
• 或者直接用 py -3.12 來指定版本（推薦）
• 或者在項(xiàng)目中使用虛擬環(huán)境，隔離不同版本

四、pip在Windows上的深度配置

4.1 pip配置文件的位置

在第2篇文章中我們簡單配置了pip鏡像源。這里詳細(xì)說說Windows上pip的配置文件體系。

pip的配置有三級(jí)優(yōu)先級(jí)（后面覆蓋前面）：

# 查看pip當(dāng)前生效的配置
pip config list
# 查看配置文件的具體位置
pip config list -v

推薦使用用戶級(jí)配置（%USERPROFILE%\pip\pip.ini），不影響其他用戶，也不需要管理員權(quán)限。

4.2 完整的pip.ini配置參考

[global]
# 鏡像源
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
# 額外的鏡像源（主源掛了就嘗試這些）
extra-index-url = 
    https://mirrors.aliyun.com/pypi/simple
    https://pypi.mirrors.ustc.edu.cn/simple
# 超時(shí)時(shí)間（秒）
timeout = 120
# 信任的主機(jī)（跳過SSL驗(yàn)證）
trusted-host = 
    pypi.tuna.tsinghua.edu.cn
    mirrors.aliyun.com
    pypi.mirrors.ustc.edu.cn
[install]
# 安裝時(shí)總是顯示進(jìn)度條
progress-bar = on
# 不使用緩存（調(diào)試時(shí)開啟）
# no-cache-dir = false
[list]
# pip list 的輸出格式 (legacy, columns, freeze, json)
format = columns

4.3 pip緩存管理

pip會(huì)把下載的包緩存到本地，以后再安裝相同版本的包時(shí)就不需要重新下載了：

# 查看緩存目錄
pip cache dir
# 查看緩存占用空間
pip cache info
# 清理緩存（釋放磁盤空間）
pip cache purge
# 只清理特定包的緩存
pip cache remove requests

緩存目錄默認(rèn)在 %LOCALAPPDATA%\pip\cache，隨著時(shí)間推移可能會(huì)占用幾個(gè)G的空間。如果你C盤空間緊張，定期清理一下。

4.4 安裝包時(shí)的常用選項(xiàng)

# 安裝指定版本
pip install requests==2.28.0
# 安裝大于等于某版本
pip install 'requests>=2.28.0'
# 安裝時(shí)不使用緩存（適用于懷疑緩存有問題）
pip install requests --no-cache-dir
# 安裝到用戶目錄而不是系統(tǒng)目錄（不需要管理員權(quán)限）
pip install requests --user
# 從requirements.txt批量安裝
pip install -r requirements.txt
# 生成當(dāng)前環(huán)境的包列表
pip freeze > requirements.txt
# 升級(jí)pip自身
python -m pip install --upgrade pip

五、Windows Terminal：命令行體驗(yàn)升級(jí)

5.1 告別老舊的CMD

Windows自帶的命令提示符（CMD）功能非常有限：不能多標(biāo)簽頁、字體難看、顏色單調(diào)、不支持Unicode的一些特殊字符。

Microsoft開發(fā)了一款全新的終端工具：Windows Terminal。它支持多標(biāo)簽頁、自定義主題、GPU加速渲染、Unicode完美支持。你可以在Microsoft Store中免費(fèi)下載。

5.2 安裝Windows Terminal

① 打開Microsoft Store（Win 10/11自帶）

② 搜索"Windows Terminal"

③ 點(diǎn)擊"獲取"安裝

或者使用winget命令行安裝：

winget install Microsoft.WindowsTerminal

5.3 配置Windows Terminal用于Python開發(fā)

打開Windows Terminal，點(diǎn)擊標(biāo)簽欄的"+“下拉菜單→"設(shè)置”（或按 Ctrl + ,）。

推薦配置項(xiàng)：

外觀設(shè)置（settings.json核心部分）：

{
    "profiles": {
        "defaults": {
            "fontFace": "Cascadia Code",  // 微軟的現(xiàn)代等寬字體，支持連字
            "fontSize": 12,
            "cursorShape": "filledBox",
            "startingDirectory": "D:\\Projects\\Python"  // 默認(rèn)打開的工作目錄
        },
        "list": [
            {
                "guid": "{...}",
                "name": "Python Dev",
                "commandline": "cmd.exe",
                "startingDirectory": "D:\\Projects\\Python",
                "tabTitle": "Python",
                "suppressApplicationTitle": true
            }
        ]
    }
}

Windows Terminal支持在同一個(gè)窗口里同時(shí)打開CMD、PowerShell、Git Bash等多個(gè)標(biāo)簽頁。寫Python時(shí)，可以一個(gè)標(biāo)簽頁跑程序，另一個(gè)標(biāo)簽頁操作git，效率極高。

5.4 讓終端運(yùn)行python更方便

在Windows Terminal的設(shè)置中，你可以添加一個(gè)專門的Python配置：

{
    "guid": "{生成一個(gè)新的GUID}",
    "name": "Python 3.12",
    "commandline": "D:\\Python312\\python.exe",
    "icon": "D:\\Python312\\python.exe",
    "hidden": false
}

這樣在Windows Terminal的"+"菜單中就會(huì)多出一個(gè)"Python 3.12"的選項(xiàng)，點(diǎn)擊直接打開Python交互環(huán)境。

六、PowerShell中的Python使用技巧

6.1 PowerShell vs CMD

PowerShell是Windows的新一代命令行解釋器，比CMD強(qiáng)大得多。如果你還在用CMD，建議遷移到PowerShell或Windows Terminal中配合使用。

# PowerShell中運(yùn)行Python腳本
python hello.py
# 使用管道
python -c "print('hello')" | Out-File output.txt
# 查看Python命令的幫助
Get-Help python
# PowerShell特有的變量和Python配合
$name = "小明"
python -c "print('Hello $env:name')"  # 這樣不行
python -c "import os; print(f'Hello {os.environ[\"name\"]}')"  # 這樣也不行
# 正確做法：
$env:NAME = "小明"
python -c "import os; print('Hello ' + os.environ['NAME'])"

6.2 PowerShell執(zhí)行策略問題

在PowerShell中運(yùn)行Python虛擬環(huán)境的激活腳本時(shí)，可能會(huì)遇到執(zhí)行策略錯(cuò)誤：

# 錯(cuò)誤信息：
# 無法加載文件 xxx\Scripts\Activate.ps1，因?yàn)樵诖讼到y(tǒng)上禁止運(yùn)行腳本
# 查看當(dāng)前執(zhí)行策略
Get-ExecutionPolicy
# 修改為允許本地腳本運(yùn)行（需要管理員權(quán)限的PowerShell）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

RemoteSigned 策略允許運(yùn)行本地創(chuàng)建的腳本，但下載的腳本需要數(shù)字簽名。這是安全和使用便利之間的一個(gè)平衡選擇。

6.3 創(chuàng)建PowerShell別名簡化操作

編輯你的PowerShell配置文件：

# 查看配置文件路徑
echo $PROFILE
# 如果配置文件不存在，創(chuàng)建它
New-Item -Path $PROFILE -Type File -Force
# 編輯配置文件
notepad $PROFILE

在配置文件中添加Python相關(guān)的別名：

# Python相關(guān)別名
function py { python $args }
function pipi { pip install $args }
function pipu { pip uninstall $args }
function pipl { pip list }
function venv-new { python -m venv $args[0]; Write-Host "虛擬環(huán)境 $args[0] 創(chuàng)建完成！" }
function venv-on { .\$args[0]\Scripts\Activate.ps1 }
function venv-off { deactivate }
# 快速進(jìn)入常用的Python項(xiàng)目目錄
function cd-py { Set-Location D:\Projects\Python }

保存后重新打開PowerShell，你就可以用簡短的命令操作了：

cd-py              # 快速進(jìn)入Python目錄
venv-new myproject # 創(chuàng)建虛擬環(huán)境
venv-on myproject  # 激活虛擬環(huán)境
pipi requests      # 安裝包
pipl               # 列出已安裝的包

七、多版本Python共存的完整方案

7.1 為什么需要多版本

實(shí)際工作中你可能會(huì)遇到這些場景：

• 公司老項(xiàng)目用的是Python 3.9，新項(xiàng)目要用Python 3.12
• 測試一個(gè)第三方庫是否兼容不同Python版本
• 想試用最新版本Python的新特性，但保持主力開發(fā)版本不變

7.2 方案一：py launcher（最推薦）

這是Windows上最簡單優(yōu)雅的方案：

# 查看所有已安裝的Python
py --list
# 創(chuàng)建虛擬環(huán)境時(shí)指定版本
py -3.9 -m venv project_old
py -3.11 -m venv project_stable
py -3.12 -m venv project_new
# 用pip安裝包時(shí)指定版本
py -3.9 -m pip install pandas
py -3.12 -m pip install pandas
# 在腳本shebang中指定版本
#!python3.9
import sys
print(sys.version)

7.3 方案二：虛擬環(huán)境隔離（必學(xué)）

無論你用哪個(gè)Python版本，每個(gè)項(xiàng)目都應(yīng)該有自己的虛擬環(huán)境：

# 創(chuàng)建虛擬環(huán)境
python -m venv myproject_env
# 激活虛擬環(huán)境（Windows）
myproject_env\Scripts\activate
# 激活后，命令行前綴會(huì)顯示環(huán)境名
(myproject_env) D:\Projects>
# 此時(shí)安裝的包都只在當(dāng)前環(huán)境中
pip install pandas
# 退出虛擬環(huán)境
deactivate

虛擬環(huán)境的核心思想：每個(gè)項(xiàng)目擁有一套獨(dú)立的第三方包。項(xiàng)目A用pandas 1.5，項(xiàng)目B用pandas 2.0，互不干擾。

7.4 方案三：使用conda

如果你涉及數(shù)據(jù)科學(xué)、機(jī)器學(xué)習(xí)，conda是一個(gè)威力強(qiáng)大的選擇：

# 安裝Miniconda（輕量版，只有conda+python+pip）
# 從 https://docs.conda.io/en/latest/miniconda.html 下載
# 創(chuàng)建不同版本的Python環(huán)境
conda create -n py39 python=3.9
conda create -n py311 python=3.11
conda create -n py312 python=3.12
# 激活環(huán)境
conda activate py312
# 安裝包（conda會(huì)處理更復(fù)雜的依賴關(guān)系）
conda install numpy pandas matplotlib
# 查看所有環(huán)境
conda env list
# 導(dǎo)出環(huán)境配置
conda env export > environment.yml

conda和pip的核心區(qū)別在于：conda不僅管理Python包，還管理非Python的依賴（比如C語言庫、系統(tǒng)級(jí)工具）。這對(duì)科學(xué)計(jì)算庫（numpy、scipy等）尤其重要，因?yàn)樗鼈兊讓右蕾嚧罅緾/Fortran庫。

八、常用IDE和編輯器的選擇

8.1 各編輯器簡明對(duì)比

后續(xù)我們有專門的PyCharm和VS Code詳細(xì)教程。這里給出結(jié)論：

• 如果你是新手，想省心：選PyCharm社區(qū)版
• 如果你需要同時(shí)寫多種語言：選VS Code
• 如果你的電腦配置不高（4GB內(nèi)存）：選VS Code或Sublime Text
• 如果你做數(shù)據(jù)科學(xué)：選Jupyter Notebook / Jupyter Lab

8.2 不用IDE也能寫Python

在配置好PATH的前提下，任何文本編輯器都可以寫Python：

# 用記事本寫Python（最簡方法）
notepad hello.py
# 寫好代碼后，命令行運(yùn)行
python hello.py

當(dāng)然，沒有代碼補(bǔ)全和語法高亮，寫起來會(huì)比較辛苦。但理解這一點(diǎn)很重要：IDE只是輔助工具，真正的"寫代碼+運(yùn)行"就靠python.exe就夠了。

九、Windows特有的常見問題排查

9.1 “api-ms-win-crt-runtime-l1-1-0.dll 缺失”

這是Windows 7或Windows Server 2008 R2等老系統(tǒng)上常見的問題。

原因：缺少Visual C++ Redistributable for Visual Studio 2015運(yùn)行庫。

解決方法：

• 下載并安裝 VC_redist.x64.exe（從微軟官網(wǎng)）
• 或者把系統(tǒng)更新到Windows 10/11

9.2 Python安裝后無法通過https下載包

WARNING: Retrying ... SSL: CERTIFICATE_VERIFY_FAILED

原因：通常是公司網(wǎng)絡(luò)有代理或者系統(tǒng)根證書過期。

解決方法：

# 臨時(shí)跳過SSL驗(yàn)證（不推薦，僅用于緊急情況）
pip install requests --trusted-host pypi.org --trusted-host files.pythonhosted.org
# 永久解決（推薦）：更新根證書
# 方法1：安裝/更新 certifi 包
pip install --upgrade certifi
# 方法2：在pip.ini中配置信任主機(jī)（見第四節(jié)）

9.3 中文編碼問題

Windows的默認(rèn)編碼是GBK，而Python 3默認(rèn)使用UTF-8。這在處理中文文件時(shí)可能出問題：

# 寫文件時(shí)指定編碼
with open('中文文件.txt', 'w', encoding='utf-8') as f:
    f.write('Python中文處理')
# 讀文件時(shí)指定編碼
with open('中文文件.txt', 'r', encoding='utf-8') as f:
    content = f.read()
# 如果遇到GBK編碼的文件
with open('老文件.txt', 'r', encoding='gbk') as f:
    content = f.read()

從Python 3.7開始，Windows上的Python默認(rèn)使用UTF-8編碼。但為了兼容性，處理中文文件時(shí)最好顯式指定 encoding='utf-8'。

9.4 文件關(guān)聯(lián)問題

雙擊 .py 文件時(shí)可能出現(xiàn)的情況：

• 直接運(yùn)行：代碼一閃而過（因?yàn)槭强刂婆_(tái)程序，執(zhí)行完就關(guān)了）
• 用編輯器打開：如果你裝了PyCharm或VS Code
• 顯示"打開方式"對(duì)話框：沒有正確設(shè)置文件關(guān)聯(lián)

修改方法：右鍵 .py 文件→"屬性"→"打開方式"→選擇你想要的程序。

十、Windows上Python開發(fā)的最佳實(shí)踐總結(jié)

一套完整的、精心配置的Windows Python開發(fā)環(huán)境應(yīng)該包括：

1. Python 3.11或3.12：從python.org下載安裝，務(wù)必勾選"Add Python to PATH"
2. pip鏡像源配置：%USERPROFILE%\pip\pip.ini 中配置清華或阿里鏡像
3. py launcher：利用它管理多版本Python
4. Windows Terminal：取代老舊的CMD，享受多標(biāo)簽和美觀界面
5. 代碼編輯器：PyCharm社區(qū)版或VS Code，根據(jù)個(gè)人偏好選擇
6. 每個(gè)項(xiàng)目使用虛擬環(huán)境：python -m venv env，隔離項(xiàng)目依賴
7. 編碼習(xí)慣：文件操作時(shí)顯式指定 encoding='utf-8'

把這七樣配置好，你的Windows就完全可以勝任從入門學(xué)習(xí)到專業(yè)開發(fā)的Python工作。不要相信"寫Python必須用Mac/Linux"的說法——Windows上的Python開發(fā)生態(tài)已經(jīng)非常成熟，足夠你從零到精通。

以上就是Windows平臺(tái)配置Python環(huán)境的入門教學(xué)的詳細(xì)內(nèi)容，更多關(guān)于Windows Python環(huán)境配置的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論