前言

寫(xiě) Python 代碼時(shí)，很多人會(huì)遇到 “環(huán)境混亂” 的糟心事：裝了多個(gè) Python 版本導(dǎo)致pip調(diào)用錯(cuò)亂，第三方庫(kù)沖突讓腳本報(bào)錯(cuò)，甚至卸載后重裝仍有殘留文件 —— 其實(shí)解決這些問(wèn)題的核心，是 “徹底卸載舊環(huán)境，再干凈重裝”，但很多人不知道 “怎么卸才算徹底”。今天這篇推文，就為大家?guī)?lái) Python“完整卸載 + 重裝” 的保姆級(jí)指南，覆蓋 Windows 和 macOS 兩大系統(tǒng)，從 “卸載殘留文件” 到 “重裝后環(huán)境驗(yàn)證”，每一步都有詳細(xì)操作，全程無(wú)復(fù)雜代碼，幫你快速恢復(fù)干凈的 Python 環(huán)境。

一、為什么要 “完整卸載”？這些坑都是 “卸載不徹底” 惹的

• 版本沖突：明明卸載了 Python 3.8，卻還能在命令行調(diào)出python 3.8 --version，新安裝的 3.12 無(wú)法正常使用；
• pip 錯(cuò)亂：用pip install裝庫(kù)時(shí)，庫(kù)被裝到舊版本的 Python 路徑下，新環(huán)境找不到；
• 環(huán)境變量污染：舊 Python 的路徑還在系統(tǒng)環(huán)境變量里，導(dǎo)致python命令始終指向舊版本。

所以，“完整卸載” 的核心是 “三刪”：刪安裝目錄、刪殘留文件、刪環(huán)境變量，缺一不可，這樣才能給新 Python 環(huán)境 “騰干凈地方”。

二、Windows 系統(tǒng)：Python 完整卸載，4 步徹底清干凈

1.引入庫(kù)

Windows 系統(tǒng)的 Python 卸載需要手動(dòng)處理 “控制面板卸載 + 殘留文件刪除 + 環(huán)境變量清理”，按以下 4 步操作，確保無(wú)殘留：

第一步：通過(guò)控制面板卸載 Python 主程序

這是卸載的基礎(chǔ)步驟，先刪除 Python 的核心安裝文件：

• 按下Win+R，輸入control打開(kāi) “控制面板”，選擇 “程序和功能”；
• 在程序列表中找到你要卸載的 Python 版本（比如 “Python 3.8.10”“Python 3.12.0”），右鍵選擇 “卸載”；
• 彈出卸載窗口后，務(wù)必勾選 “Delete Python.exe”（刪除 Python 可執(zhí)行文件）和 “Remove Python from PATH”（從環(huán)境變量移除路徑），點(diǎn)擊 “Uninstall”，等待進(jìn)度條完成。

注意：如果安裝了多個(gè) Python 版本，要逐個(gè)卸載，避免遺漏。

第二步：刪除 Python 殘留文件夾（關(guān)鍵?。?/h4>

控制面板卸載后，會(huì)留下兩個(gè)核心殘留文件夾，必須手動(dòng)刪除，否則后續(xù)重裝會(huì)有沖突：

• 用戶(hù)目錄殘留：打開(kāi) “此電腦”，在地址欄輸入%USERPROFILE%，進(jìn)入用戶(hù)目錄，刪除這兩個(gè)文件夾：

AppData\Local\Programs\Python：存放 Python 的安裝殘留文件；

AppData\Roaming\Python：存放pip安裝的第三方庫(kù)殘留（比如 numpy、pandas的舊版本）。

• 安裝目錄殘留：如果當(dāng)初安裝時(shí)自定義了路徑（比如 “D:\Python38”），到對(duì)應(yīng)磁盤(pán)找到該文件夾，徹底刪除（若提示 “文件正在使用”，先關(guān)閉所有命令行、IDE，再重試）。

驗(yàn)證：刪除后，在 “此電腦” 搜索框輸入 “Python”，若找不到對(duì)應(yīng)版本的安裝文件夾，說(shuō)明殘留目錄已清干凈。

第三步：清理系統(tǒng)環(huán)境變量（避免路徑污染）

即使卸載時(shí)勾選了 “Remove Python from PATH”，仍可能有舊路徑殘留，需手動(dòng)檢查清理：

• 右鍵 “此電腦”→“屬性”→“高級(jí)系統(tǒng)設(shè)置”→“環(huán)境變量”；
• 在 “用戶(hù)變量” 和 “系統(tǒng)變量” 中，分別找到 “Path” 變量，點(diǎn)擊 “編輯”；
• 刪除所有包含 “Python” 的路徑（比如 “C:\Python38\”“C:\Python38\Scripts\”），點(diǎn)擊 “確定” 保存；
• 關(guān)閉所有已打開(kāi)的命令行窗口（環(huán)境變量修改需重啟命令行生效）。

驗(yàn)證：重新打開(kāi)命令行，輸入python --version和pip --version，若提示 “不是內(nèi)部或外部命令”，說(shuō)明環(huán)境變量已清理干凈。

第四步：刪除注冊(cè)表殘留（可選，進(jìn)階操作）

如果后續(xù)重裝仍有問(wèn)題（比如命令行始終指向舊版本），可清理注冊(cè)表殘留（操作前建議備份注冊(cè)表，避免誤刪系統(tǒng)文件）：

• 按下Win+R，輸入regedit打開(kāi) “注冊(cè)表編輯器”；
• 分別定位到以下路徑，刪除包含對(duì)應(yīng) Python 版本的文件夾：HKEY_CURRENT_USER\Software\Python
• 關(guān)閉注冊(cè)表編輯器，重啟電腦，確保修改生效。

三、macOS 系統(tǒng)：Python 完整卸載，3 步搞定（區(qū)別系統(tǒng)自帶 Python）

macOS 系統(tǒng)需要注意 “用戶(hù)安裝的 Python” 和 “系統(tǒng)自帶 Python” 的區(qū)別：系統(tǒng)自帶的 Python（比如 Python 2.7）用于支撐系統(tǒng)功能，嚴(yán)禁卸載，我們要卸載的是自己后來(lái)安裝的 Python（比如 3.8、3.12）。

第一步：確認(rèn)要卸載的 Python 版本（避免刪錯(cuò)系統(tǒng)版本）

先通過(guò)命令行確認(rèn)自己安裝的 Python 版本，避免誤刪系統(tǒng)自帶版本：

• 打開(kāi) “終端”，輸入which python3（macOS 默認(rèn)用python3區(qū)分用戶(hù)安裝版本），查看安裝路徑（比如/Library/Frameworks/Python.framework/Versions/3.8）；
• 輸入python3 --version，記錄要卸載的版本號(hào)（比如 3.8.10），后續(xù)操作都圍繞這個(gè)版本展開(kāi)。

第二步：刪除 Python 核心文件和庫(kù)

macOS 的 Python 主要存放在 “框架目錄” 和 “應(yīng)用程序目錄”，按以下步驟刪除：

• 刪除框架目錄：在終端輸入sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.8（將 “3.8” 換成你要卸載的版本號(hào)），輸入電腦密碼確認(rèn)（sudo需要管理員權(quán)限）；
• 刪除應(yīng)用程序快捷方式：打開(kāi) “應(yīng)用程序” 文件夾，找到 “Python 3.8” 文件夾（對(duì)應(yīng)版本），拖到廢紙簍并清空；
• 刪除pip殘留：輸入sudo rm -rf /usr/local/bin/pip3.8（刪除對(duì)應(yīng)版本的pip），以及/usr/local/bin目錄下所有包含 “python3.8” 的文件（可通過(guò)ls /usr/local/bin | grep python3.8查看）。

第三步：清理環(huán)境變量和緩存

最后清理可能殘留的環(huán)境變量和用戶(hù)緩存：

• 檢查環(huán)境變量：輸入open ~/.bash_profile（若用 Zsh 則輸入open ~/.zshrc），刪除文件中包含 “Python 3.8” 的路徑配置（比如export PATH=“/Library/Frameworks/Python.framework/Versions/3.8/bin:$PATH”），保存后關(guān)閉文件；
• 更新環(huán)境變量：在終端輸入source ~/.bash_profile（或source ~/.zshrc），讓修改生效；
• 刪除用戶(hù)緩存：輸入rm -rf ~/Library/Caches/Python，刪除用戶(hù)目錄下的 Python 緩存文件。

驗(yàn)證：重啟終端，輸入python3 --version，若提示 “command not found”，說(shuō)明 macOS 的 Python 已徹底卸載。

四、Python 重裝：選擇版本 + 正確安裝，2 步避免再出問(wèn)題

卸載干凈后，就可以重裝 Python 了，關(guān)鍵是 “選對(duì)版本 + 正確配置”，避免再次踩坑：

第一步：選擇合適的 Python 版本（別盲目追新）

很多人會(huì)糾結(jié) “裝哪個(gè)版本”，其實(shí)核心原則是 “匹配需求”，而不是盲目裝最新版：

• 新手入門(mén)：優(yōu)先選擇 “Python 3.10-3.12”，這幾個(gè)版本兼容性好，支持大部分第三方庫(kù)（比如pandas、PyTorch），且 bug 較少；
• 項(xiàng)目適配：如果要運(yùn)行舊項(xiàng)目，需裝項(xiàng)目要求的版本（比如項(xiàng)目文檔寫(xiě) “需 Python 3.8+”，就裝 3.8 或 3.9，避免版本過(guò)高導(dǎo)致庫(kù)不兼容）；
• 避免冷門(mén)版本：別裝 alpha/beta 測(cè)試版（比如 3.13.0a1），這類(lèi)版本可能有未修復(fù)的 bug，適合開(kāi)發(fā)者測(cè)試，不適合日常使用。

下載渠道：從 Python 官網(wǎng)（www.python.org/downloads）下載，選擇對(duì)應(yīng)系統(tǒng)的安裝包（Windows 選 “Windows Installer (64-bit)”，macOS 選 “macOS 64-bit universal2 installer”），避免第三方平臺(tái)的捆綁安裝包。

第二步：安裝 Python，關(guān)鍵選項(xiàng)別漏選

安裝時(shí)的幾個(gè)關(guān)鍵選項(xiàng)，直接影響后續(xù)使用，務(wù)必勾選：

Windows 系統(tǒng)安裝：

• 打開(kāi)下載的.exe安裝包，第一時(shí)間勾選 “Add Python.exe to PATH”（這是最關(guān)鍵的一步，避免后續(xù)手動(dòng)配置環(huán)境變量）；
• 建議勾選 “Install launcher for all users”（為所有用戶(hù)安裝啟動(dòng)器，方便多用戶(hù)使用）；
• 點(diǎn)擊 “Customize installation”，默認(rèn)勾選 “Documentation”“pip”“tcl/tk and IDLE”（pip是裝庫(kù)的核心工具，IDLE 是自帶的簡(jiǎn)單編輯器，都要保留）；
• 點(diǎn)擊 “Next”，默認(rèn)安裝路徑即可（或自定義路徑，建議路徑中無(wú)中文和空格，比如 “D:\Python312”），點(diǎn)擊 “Install”，等待安裝完成。

macOS 系統(tǒng)安裝：

• 打開(kāi)下載的.pkg安裝包，按提示點(diǎn)擊 “繼續(xù)”，默認(rèn)安裝路徑即可（一般安裝在/Library/Frameworks/Python.framework/Versions/3.12）；
• 安裝完成后，打開(kāi)終端，輸入python3 --version，若顯示 “Python 3.12.0”，說(shuō)明安裝成功；
• （可選）為了方便調(diào)用，可設(shè)置python命令別名：輸入echo ‘alias python=“python3”’ >> _{/.bash_profile（或}/.zshrc），再輸入source ~/.bash_profile，后續(xù)輸入python --version也能調(diào)出對(duì)應(yīng)版本。

五、重裝后驗(yàn)證：3 步確認(rèn) Python 環(huán)境正常

重裝后別著急寫(xiě)代碼，先做 3 個(gè)驗(yàn)證，確保環(huán)境沒(méi)問(wèn)題：

驗(yàn)證 Python 可正常調(diào)用

• Windows：打開(kāi)命令行，輸入python --version，顯示安裝的版本號(hào)（比如 “Python 3.12.0”）；
• macOS：打開(kāi)終端，輸入python3 --version（或python --version，若設(shè)置了別名），顯示對(duì)應(yīng)版本號(hào)，無(wú) “command not found” 提示。

驗(yàn)證 pip 可正常使用

pip 是安裝第三方庫(kù)的核心工具，必須確認(rèn)能正常調(diào)用：

• 輸入pip --version（Windows）或pip3 --version（macOS），顯示 “pip X.Y.Z from … (python 3.12)”，說(shuō)明 pip 與當(dāng)前 Python 版本匹配；
• 嘗試用 pip 裝一個(gè)簡(jiǎn)單的庫(kù)，比如pip install numpy（Windows）或pip3 install numpy（macOS），安裝完成后，輸入python（或python3）進(jìn)入交互環(huán)境，輸入import numpy，無(wú)報(bào)錯(cuò)說(shuō)明庫(kù)安裝成功。

驗(yàn)證 IDE 可正常關(guān)聯(lián)

如果用 VS Code、PyCharm 等 IDE，需確認(rèn) IDE 已關(guān)聯(lián)新安裝的 Python：

• VS Code：打開(kāi) VS Code，新建.py文件，點(diǎn)擊右下角的 “Python X.X.X”，在彈出的列表中選擇新安裝的版本（比如 “Python 3.12.0 64-bit”）；
• PyCharm：打開(kāi) PyCharm，新建項(xiàng)目時(shí)，在 “Python interpreter” 中選擇 “Existing environment”，找到新 Python 的安裝路徑（Windows 一般在 “C:\Python312\python.exe”，macOS 在 “/Library/Frameworks/Python.framework/Versions/3.12/bin/python3”），點(diǎn)擊 “Create”，創(chuàng)建后運(yùn)行print(“Hello”)，能正常輸出說(shuō)明關(guān)聯(lián)成功。

六、避坑指南：重裝后常見(jiàn)問(wèn)題，一招解決

即使按步驟操作，重裝后仍可能遇到小問(wèn)題，以下是 2 個(gè)高頻問(wèn)題的解決方法：

問(wèn)題 1：Windows 下pip調(diào)用報(bào)錯(cuò) “Fatal error in launcher”

• 原因：可能是之前的pip殘留文件與新環(huán)境沖突，或pip本身?yè)p壞；
• 解決：在命令行輸入python -m pip install --upgrade pip --force-reinstall，強(qiáng)制重新安裝pip，修復(fù)損壞的文件，之后再用pip裝庫(kù)即可正常使用。

問(wèn)題 2：macOS 下安裝庫(kù)時(shí)提示 “Permission denied”

• 原因：權(quán)限不足，無(wú)法將庫(kù)安裝到系統(tǒng)級(jí)路徑；
• 解決：不用sudo（避免權(quán)限污染系統(tǒng)文件），而是用 “用戶(hù)級(jí)安裝”，輸入pip3 install --user numpy（–user參數(shù)表示將庫(kù)裝到用戶(hù)目錄下），后續(xù)調(diào)用時(shí) Python 能正常找到該庫(kù)。

總結(jié)：環(huán)境干凈，代碼才順暢

Python 的 “環(huán)境問(wèn)題” 看似麻煩，其實(shí)只要掌握 “徹底卸載 + 正確重裝” 的方法，就能輕松解決。核心記住三點(diǎn)：

• 卸載時(shí) “三刪”：刪主程序、刪殘留文件、刪環(huán)境變量，不留隱患；
• 重裝時(shí) “三選”：選合適版本、選官網(wǎng)安裝包、選對(duì)關(guān)鍵選項(xiàng)（尤其是Add to PATH）；
• 重裝后 “三驗(yàn)”：驗(yàn) Python 調(diào)用、驗(yàn) pip 功能、驗(yàn) IDE 關(guān)聯(lián)，確保環(huán)境正常。

以后再遇到 “版本沖突”“庫(kù)裝不上” 的問(wèn)題，不用再焦慮，按這份指南 “卸干凈重裝”，就能恢復(fù)清爽的 Python 環(huán)境，讓代碼跑得更順暢。

到此這篇關(guān)于Python環(huán)境崩了的完整卸載及重裝指南的文章就介紹到這了,更多相關(guān)Python卸載及重裝內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論