前言

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

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

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

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

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

1.引入庫

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

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

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

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

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

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

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

• 用戶目錄殘留：打開 “此電腦”，在地址欄輸入%USERPROFILE%，進入用戶目錄，刪除這兩個文件夾：

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

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

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

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

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

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

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

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

第四步：刪除注冊表殘留（可選，進階操作）

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

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

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

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

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

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

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

第二步：刪除 Python 核心文件和庫

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

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

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

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

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

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

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

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

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

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

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

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

第二步：安裝 Python，關鍵選項別漏選

安裝時的幾個關鍵選項，直接影響后續(xù)使用，務必勾選：

Windows 系統(tǒng)安裝：

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

macOS 系統(tǒng)安裝：

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

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

重裝后別著急寫代碼，先做 3 個驗證，確保環(huán)境沒問題：

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

• Windows：打開命令行，輸入python --version，顯示安裝的版本號（比如 “Python 3.12.0”）；
• macOS：打開終端，輸入python3 --version（或python --version，若設置了別名），顯示對應版本號，無 “command not found” 提示。

驗證 pip 可正常使用

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

• 輸入pip --version（Windows）或pip3 --version（macOS），顯示 “pip X.Y.Z from … (python 3.12)”，說明 pip 與當前 Python 版本匹配；
• 嘗試用 pip 裝一個簡單的庫，比如pip install numpy（Windows）或pip3 install numpy（macOS），安裝完成后，輸入python（或python3）進入交互環(huán)境，輸入import numpy，無報錯說明庫安裝成功。

驗證 IDE 可正常關聯(lián)

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

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

六、避坑指南：重裝后常見問題，一招解決

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

問題 1：Windows 下pip調(diào)用報錯 “Fatal error in launcher”

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

問題 2：macOS 下安裝庫時提示 “Permission denied”

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

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

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

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

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

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

最新評論