建議先收藏，裝Python的時(shí)候一定用得上

前言

我第一次裝Python時(shí)花了3個(gè)小時(shí)。

環(huán)境變量配錯(cuò)、pip裝不上、版本沖突……后來(lái)幫同事裝又踩了一遍坑，再后來(lái)?yè)Q電腦又來(lái)一遍。第三次的時(shí)候我就在想：為什么沒(méi)人告訴我這些坑？

這篇文章是我裝了5次Python后總結(jié)出來(lái)的，照著做10分鐘搞定，幫你把坑全填了。

一、安裝Python（最容易踩坑的環(huán)節(jié)）

1.1 下載Python

打開(kāi) python.org/downloads，頁(yè)面中間會(huì)有一個(gè)黃色按鈕 "Download Python 3.12.x" ，點(diǎn)擊即可下載 Windows 安裝包（.exe）。

版本建議：選 Python 3.12+ （2026年當(dāng)前穩(wěn)定版）。3.9已經(jīng)偏舊了，很多新庫(kù)不再支持。別追求最新3.13，除非你明確需要新特性。

1.2 安裝——90%的人栽在這一步

安裝時(shí)，第一屏最底下有個(gè)勾選框，一定要勾上！

打開(kāi)安裝包后，你會(huì)看到安裝向?qū)У牡谝黄粒撞坑幸粋€(gè) "Add python.exe to PATH" 的復(fù)選框——必須勾選！ 這是90%的新手踩坑的地方。

• Add python.exe to PATH（將Python添加到環(huán)境變量）—— 必須勾！不勾后面全是坑
• pip（包管理工具）—— 默認(rèn)勾選，別取消

然后點(diǎn) "Customize installation"，建議別裝C盤根目錄，選個(gè)好找的位置，比如 D:\Python312。

我第一次裝的時(shí)候沒(méi)勾PATH，后面命令行死活找不到python，排查了1個(gè)多小時(shí)才發(fā)現(xiàn)是這個(gè)選項(xiàng)沒(méi)勾……血淚教訓(xùn)。

1.3 驗(yàn)證安裝

裝完別急著關(guān)，先驗(yàn)證一下。按 Win + R，輸入 cmd 回車，然后：

python --version
# 輸出類似：Python 3.12.x  ← 看到這個(gè)就對(duì)了
?
pip --version
# 輸出類似：pip 25.x from D:\Python312\lib\site-packages\pip (python 3.12)

看到 Python 3.12.x 和 pip 25.x 的版本號(hào)輸出，說(shuō)明安裝成功

如果顯示 'python' 不是內(nèi)部或外部命令——恭喜你踩到第一個(gè)坑了，往下看第四部分環(huán)境變量配置。

二、配置開(kāi)發(fā)環(huán)境

2.1 VS Code（推薦新手用）

VS Code免費(fèi)、輕量、插件生態(tài)強(qiáng)，新手首選。

裝完VS Code后，必須裝一個(gè)Python擴(kuò)展，不然跟記事本沒(méi)區(qū)別：

1. 按 Ctrl + Shift + X 打開(kāi)擴(kuò)展面板
2. 搜索 "Python"
3. 安裝 Microsoft 官方的 Python 擴(kuò)展（搜索結(jié)果第一個(gè)，下載量100M+的那個(gè)，作者顯示 "Microsoft"）

安裝完擴(kuò)展后，VS Code 右下角狀態(tài)欄會(huì)顯示當(dāng)前 Python 版本，如果沒(méi)顯示說(shuō)明還沒(méi)選解釋器，看下面。

配置Python解釋器（這步不做代碼跑不起來(lái)）：

1. 按 Ctrl + Shift + P 打開(kāi)命令面板（頂部會(huì)彈出一個(gè)輸入框）
2. 輸入 "Python: Select Interpreter"
3. 在下拉列表中選擇你剛安裝的 Python 3.12.x，路徑類似 D:\Python312\python.exe

如果列表里沒(méi)有你的Python版本，點(diǎn) "Enter interpreter path..." 手動(dòng)選擇安裝目錄下的 python.exe。

2.2 PyCharm（功能最全）

JetBrains出品，功能強(qiáng)大，適合做大項(xiàng)目。

• PyCharm Community（免費(fèi)）—— 學(xué)習(xí)和小項(xiàng)目夠用
• PyCharm Professional（付費(fèi)）—— 支持Web開(kāi)發(fā)、數(shù)據(jù)庫(kù)等高級(jí)功能

新手建議先用VS Code，PyCharm太重了，容易把人勸退。

2.3 Jupyter Notebook（數(shù)據(jù)科學(xué)必備）

做數(shù)據(jù)分析、機(jī)器學(xué)習(xí)首選，所見(jiàn)即所得——寫一段代碼立刻看到結(jié)果。

單獨(dú)安裝：

pip install jupyter notebook

啟動(dòng)：

jupyter notebook

瀏覽器會(huì)自動(dòng)打開(kāi)。如果你裝了Anaconda，Jupyter已經(jīng)內(nèi)置了，不用單獨(dú)裝。

三、包管理——pip和conda怎么選？

3.1 pip（最常用）

pip是Python官方的包管理工具，99%的Python開(kāi)發(fā)者都用它。

# 安裝包
pip install requests          # 安裝單個(gè)包
pip install pandas numpy      # 同時(shí)安裝多個(gè)
pip install pandas==2.2.0     # 安裝指定版本
?
# 升級(jí)包
pip install --upgrade pandas
?
# 查看已安裝
pip list
?
# 卸載
pip uninstall requests
?
# 導(dǎo)出依賴列表（項(xiàng)目部署必備?。?
pip freeze > requirements.txt

3.2 conda（數(shù)據(jù)科學(xué)場(chǎng)景）

conda的優(yōu)勢(shì)是可以管理非Python依賴（比如C庫(kù)），適合科學(xué)計(jì)算。

conda install numpy pandas           # 安裝包
conda create -n myenv python=3.12    # 創(chuàng)建虛擬環(huán)境
conda activate myenv                 # 激活環(huán)境

3.3 一張圖說(shuō)清pip和conda的選擇

pip和conda不要混用，選一個(gè)堅(jiān)持到底，不然環(huán)境會(huì)亂套。這是我自己踩過(guò)的坑，conda環(huán)境里用pip裝包，版本沖突到懷疑人生。

四、環(huán)境變量——踩坑重災(zāi)區(qū)

4.1 什么是環(huán)境變量？

簡(jiǎn)單說(shuō)：你在命令行輸入 python，系統(tǒng)怎么知道去哪找 python.exe？靠的就是PATH環(huán)境變量。

4.2 手動(dòng)配置（如果你安裝時(shí)忘了勾PATH）

右鍵"此電腦" → 屬性 → 高級(jí)系統(tǒng)設(shè)置 → 環(huán)境變量

在"系統(tǒng)變量"里找到 Path，雙擊編輯

新增兩條路徑：

D:\Python312\
D:\Python312\Scripts\

確定保存，重新打開(kāi)命令行窗口（不重啟不生效?。?/p>

操作路徑：右鍵"此電腦" → 屬性 → 高級(jí)系統(tǒng)設(shè)置 → 環(huán)境變量 → 在"系統(tǒng)變量"中找到 Path 雙擊 → 點(diǎn)"新建" → 分別添加 D:\Python312 和 D:\Python312\Scripts → 確定。

4.3 驗(yàn)證

where python
# 應(yīng)該輸出：D:\Python312\python.exe

五、常見(jiàn)坑和解決方案

坑1：'python' 不是內(nèi)部或外部命令

這是新手遇到最多的坑，沒(méi)有之一。

原因：安裝時(shí)沒(méi)勾選"Add Python to PATH"，或者手動(dòng)配置了但沒(méi)重啟命令行。

解決：

• 方案A：卸了重裝，這次記得勾
• 方案B：按第四部分手動(dòng)配置環(huán)境變量，然后重啟命令行

坑2：pip安裝包巨慢，甚至超時(shí)

原因：默認(rèn)從國(guó)外服務(wù)器下載，國(guó)內(nèi)網(wǎng)絡(luò)經(jīng)常連不上。

解決：換國(guó)內(nèi)鏡像源，速度提升10倍：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

常用鏡像（選一個(gè)就行）：

一勞永逸的方法（不用每次都加 -i）：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

坑3：pip和python版本不匹配

裝完發(fā)現(xiàn)pip裝的包import不了，原因是系統(tǒng)里有多個(gè)Python版本，pip對(duì)應(yīng)的是另一個(gè)版本。

解決：

# 用明確的python路徑裝pip包
python -m pip install requests
?
# 而不是直接
pip install requests

坑4：安裝時(shí)提示權(quán)限不足

解決：右鍵安裝包 → 以管理員身份運(yùn)行

坑5：裝了VS Code但代碼跑不起來(lái)

大概率是沒(méi)選解釋器。按 Ctrl + Shift + P → 輸入 "Python: Select Interpreter" → 選你的Python版本。

六、運(yùn)行Python代碼的3種方式

6.1 腳本文件（最常用）

創(chuàng)建 .py 文件，寫代碼，命令行運(yùn)行：

# hello.py
print("Hello, World!")
name = input("請(qǐng)輸入你的名字：")
print(f"你好，{name}！歡迎來(lái)到Python的世界 ??")

python hello.py

6.2 交互式解釋器（適合測(cè)試小代碼）

命令行輸入 python，進(jìn)入交互模式：

>>> 2 + 2
4
>>> print("測(cè)試一下")
測(cè)試一下
>>> exit()  # 退出

6.3 VS Code中直接運(yùn)行

打開(kāi) .py 文件，按 F5 或點(diǎn)右上角的運(yùn)行按鈕

七、輔助工具（很有用但很多人不知道）

pydoc——命令行看文檔

pydoc print      # 查看print函數(shù)文檔
pydoc -b         # 啟動(dòng)本地文檔服務(wù)器，瀏覽器查看所有模塊

help()——代碼里查幫助

help(print)      # 查看print幫助
help(str)        # 查看str類幫助

doc——直接看文檔字符串

print(print.__doc__)

八、第一個(gè)Python程序——環(huán)境檢測(cè)

前面講了這么多，來(lái)寫個(gè)程序驗(yàn)證環(huán)境是否OK：

# check_env.py - Python環(huán)境檢測(cè)程序
?
import sys
import platform
?
def main():
    print("=" * 45)
    print("  ?? Python 環(huán)境檢測(cè)程序")
    print("=" * 45)
?
    # 環(huán)境信息
    print(f"\n  ?? Python版本：{sys.version}")
    print(f"  ?? 安裝路徑：{sys.executable}")
    print(f"  ?? 操作系統(tǒng)：{platform.system()} {platform.release()}")
    print(f"  ?? 架構(gòu)：{platform.machine()}")
?
    # 獲取用戶輸入
    print("\n" + "-" * 45)
    name = input("  你叫什么名字？").strip() or "未來(lái)的Python大佬"
    print(f"\n  ?? {name}，你的Python環(huán)境一切正常！")
    print("  接下來(lái)，讓我們開(kāi)始寫代碼吧 ??")
    print("=" * 45)
?
if __name__ == "__main__":
    main()

運(yùn)行效果：

在 VS Code 中打開(kāi) check_env.py，按 F5 運(yùn)行，終端會(huì)輸出環(huán)境信息并等待你輸入名字：

=============================================
  ?? Python 環(huán)境檢測(cè)程序
=============================================
?
  ?? Python版本：3.12.x (main, ...)
  ?? 安裝路徑：D:\Python312\python.exe
  ?? 操作系統(tǒng)：Windows 10
  ?? 架構(gòu)：AMD64
?
---------------------------------------------
  你叫什么名字？榮碼
?
  ?? 榮碼，你的Python環(huán)境一切正常！
  接下來(lái)，讓我們開(kāi)始寫代碼吧 ??
=============================================

看到這個(gè)輸出，說(shuō)明你的環(huán)境 完全OK

總結(jié)

一篇文章搞定Python環(huán)境搭建，5個(gè)坑都幫你填好了：

以上就是Python安裝與環(huán)境搭建的完整流程和避坑指南的詳細(xì)內(nèi)容，更多關(guān)于Python環(huán)境搭建的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論