Python 安装避坑指南

目录

前言

Python 作为最受欢迎的编程语言之一，被广泛应用于数据分析、人工智能、网络爬虫、Web 开发等多个领域。想要开始学习或使用 Python，第一步当然是正确安装 Python。然而，在安装和配置的过程中，常常会遇到一些让人头疼的问题：路径配置错误、多版本共存混乱、pip 不可用等等。

本文会结合 Windows、macOS、Linux 三个主流平台，分享常见的坑及解决方案，帮助你一步到位地完成 Python 环境搭建。

一、Windows 平台

1. 安装包选择与下载

2. 安装选项设置

3. 常见坑及解决方案

1. 未勾选 Add Python to PATH

2. 现象：安装完成后，在 CMD 或 PowerShell 中输入 python 提示找不到命令。
3. 解决方案：
4. 重新运行安装包，选择“Modify”修改安装选项，勾选“Add Python to PATH”；
5. 或者手动在“高级系统设置 -> 环境变量”中，将 Python 的安装路径、Scripts 路径加入到 PATH。

6. 多版本 Python 混淆

7. 现象：电脑上原本装了 Python 2.7 或其他 3.x 版本，安装新版本后，命令行却调用的是旧版本。
8. 解决方案：
9. 使用 py -0 查看已安装的 Python 版本，然后使用 py -3.x 来指定 Python 版本；
10. 或者使用虚拟环境（如 venv 或 Anaconda）来区分不同版本；
11. 如果仅需要一个版本，卸载旧版本后再重新安装，并保证 PATH 里只有一个 Python 路径。

12. pip 命令不可用或无法更新

13. 现象：输入 pip install 报错找不到 pip 或无法正确执行。
14. 解决方案：
15. 先检查 PATH 配置，pip 所在的 Scripts 文件夹是否加入了 PATH；
16. 尝试使用 python -m pip install --upgrade pip 更新 pip；
17. 如仍无法解决，可手动下载 get-pip.py 并使用 python get-pip.py 重新安装 pip。

二、macOS 平台

1. macOS 自带 Python 版本的问题

macOS 默认自带了 Python 2.x 或 Python 3.x（视 macOS 版本而定），但通常版本较旧。如果你需要最新版本或需要某些特性，推荐自行安装更高版本的 Python。

2. 常见的安装方式

1. 从 Python 官网下载并安装 DMG / PKG 文件

2. 在 Python 官方下载页面 选择适用于 macOS 的安装包进行安装，安装过程类似双击安装软件即可。
3. 安装完成后，可以在终端输入 python3 --version 检查是否为新安装的版本。

4. 通过 Homebrew 安装

5. Homebrew 是 macOS 上流行的软件包管理器。
6. 如果还没有安装 Homebrew，可以在终端执行：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

7. 安装 Python 3：

   brew update
   brew install python
   

8. 安装完成后，可用 python3 或 pip3 命令来使用 Python 3。

9. 使用 pyenv

10. 如果需要在 macOS 上同时管理多个 Python 版本，可以考虑 pyenv。
11. 安装 pyenv：

    brew install pyenv
    

12. 安装指定版本 Python：

    pyenv install 3.10.10
    pyenv global 3.10.10
    

13. 设置好之后，在终端执行 python --version 可以查看当前使用的 Python 版本。

3. 常见坑及解决方案

1. 安装新版本却仍是旧版本在运行

2. 现象：macOS 自带了 Python 2.7，装了 Python 3 后，终端输入 python 仍旧是 2.7。
3. 解决方案：
4. 使用 python3 调用 Python 3；
5. 通过 alias python=python3 或者修改 shell 配置文件（如 ~/.zshrc）来将 python 指向 Python 3（注意这样可能影响系统脚本，要谨慎操作）；
6. 使用 pyenv，通过 pyenv global 命令来切换默认 Python。

7. pip 与 pip3 的困惑

8. macOS 下常常出现 pip 或 pip3 二者并存的情况。
9. 建议使用 python3 -m pip 方式来保持一致性，这样可以明确使用的是哪一个 Python 版本的 pip。

10. 权限问题

11. 有时候在安装 Python 包时需要管理员权限。
12. 解决方案：
13. 使用 pip install --user xxx 将包安装到用户目录；
14. 或者在命令前加上 sudo（不太推荐）；
15. 更好的做法是使用虚拟环境 python3 -m venv venv 来安装依赖。

三、Linux 平台

Linux 大多会预装 Python（可能是 Python 2.x 或 Python 3.x），且系统依赖和管理脚本可能使用 Python。如果你想安装更新或特定版本的 Python，需要格外注意防止与系统默认 Python 版本产生冲突。

1. 通过系统包管理器安装

sudo apt-get update
sudo apt-get install python3 python3-pip

sudo dnf install python3 python3-pip

2. 源码编译安装

对于对版本有特殊需求的情况，可以考虑 从源码编译：

# 以 Python 3.10.10 为例
wget https://www.python.org/ftp/python/3.10.10/Python-3.10.10.tgz
tar -xf Python-3.10.10.tgz
cd Python-3.10.10
./configure --enable-optimizations
make -j 8
sudo make altinstall

这里推荐使用 altinstall 而不是 install，以避免覆盖系统默认的 python 可执行文件。

3. 常见坑及解决方案

1. 破坏系统默认 Python

2. 现象：修改了 /usr/bin/python 链接或卸载了系统自带的 Python，导致系统工具无法运行。
3. 解决方案：
4. 尽量不要手动替换或者卸载系统自带的 Python；
5. 如果要安装新版本，使用 altinstall 或者指定前缀路径安装，并使用虚拟环境隔离。

6. pip 与 pip3 的混淆

7. 如果系统默认 Python2（pip），新装的 Python3（pip3）可能与之并存。
8. 建议使用 python3 -m pip 明确你的 Python 环境，从而避免混淆。

9. 权限与依赖问题

10. 建议以普通用户身份安装 Python 包，或使用虚拟环境以避免权限问题；
11. 如果安装系统级别的软件包或者需要全局的依赖，才使用 sudo 命令。

四、虚拟环境：隔离你的项目

无论在哪个操作系统上，如果你需要使用多个项目，每个项目所需的 Python 版本和依赖包可能不同，就很容易出现冲突。推荐使用虚拟环境来解决这个问题。

1. venv 模块

Python 3 自带了 venv 模块，可以用它创建虚拟环境：

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境(Windows)
venv\Scripts\activate

# 激活虚拟环境(macOS / Linux)
source venv/bin/activate

# 安装依赖
pip install requests

# 退出虚拟环境
deactivate

2. Anaconda / Miniconda

如果你做数据分析、机器学习，Anaconda 或 Miniconda 是非常方便的一体化工具，不仅包含 Python，还集成了常见的科学计算库：

# 安装环境
conda create -n myenv python=3.9

# 激活环境
conda activate myenv

# 安装包
conda install numpy pandas

# 退出环境
conda deactivate

五、总结

最重要的，“虚拟环境” 几乎是 Python 开发中的必备技能。它能从根本上隔离不同项目中的依赖问题，极大减少安装环境带来的冲突和“踩坑”。无论你使用何种操作系统，掌握好虚拟环境，Python 的安装和管理将变得简单、高效而又干净。

作者：TravisBytes