Python作为当今最热门的编程语言之一,无论是数据分析、人工智能、Web开发还是自动化脚本,都离不开它。但很多新手在第一步——安装Python上就卡住了。别急,本文将以最详细、最直观的方式,带你一步步在Windows、macOS和Linux三大操作系统上完成Python的安装与环境配置。哪怕你是零基础,跟着做也能一次成功!


一、下载Python —— 选对版本是成功的一半

1.1 官方下载地址

打开浏览器,访问Python
页面会自动识别你的操作系统并推荐对应的安装包,但不要急着点下载,我们先了解几个关键点。

1.2 版本选择建议

  • 稳定版本:目前最新的稳定版是 Python 3.12.4(2026年7月发布),推荐新手直接安装此版本。
  • 为什么选3.x? Python 2已于2020年停止维护,务必选择Python 3。
  • 32位还是64位? 现代电脑基本都是64位系统,选择 64-bit installer。如果你不确定,右键“此电脑”->“属性”查看系统类型。

1.3 各平台下载文件类型

操作系统 推荐下载文件
Windows Windows installer (64-bit) — .exe 文件
macOS macOS 64-bit universal2 installer — .pkg 文件
Linux 一般通过包管理器安装,或下载源码编译(见下文)

二、Windows系统下安装Python(超详细图解)

2.1 运行安装包

双击下载的 python-3.12.4-amd64.exe 文件,会弹出安装窗口。

⚠️ 重中之重!
在安装窗口的左下角,有一个 “Add Python 3.12 to PATH” 复选框,请务必勾选
这会将Python添加到系统环境变量中,否则你只能在安装目录下使用Python,非常麻烦。

2.2 选择安装方式

有两种安装方式:

  • Install Now(立即安装):默认安装到 C:\Users\用户名\AppData\Local\Programs\Python\Python312,适合新手。
  • Customize installation(自定义安装):可以更改安装路径和可选功能。
    建议选择 Customize installation,以便我们能确认所有组件都被安装。

2.3 自定义安装选项

点击“Customize installation”后,你会看到可选功能列表,全部勾选(特别是 piptcl/tkIDLEPython test suite),然后点击“Next”。

2.4 高级选项设置

  • Install for all users:建议勾选,这样所有用户都能使用。
  • Install location:可以修改路径,例如 D:\Python312(避免C盘空间不足),但记住这个路径,后续可能需要用到。
  • 其他保持默认,点击“Install”开始安装。

2.5 安装完成

等待进度条走完,出现 “Setup was successful” 界面,点击“Close”关闭。

2.6 验证安装(Windows)

按下 Win + R,输入 cmd 打开命令提示符,输入:

python --version

如果显示 Python 3.12.4,说明安装成功!
再输入:

pip --version

显示pip版本信息,则说明pip也正常。

如果提示“python不是内部或外部命令”,说明你忘记勾选“Add Python to PATH”,别慌,我们手动添加环境变量(见第六部分常见问题)。


三、macOS系统下安装Python

3.1 使用官方安装包(图形化)

  1. 下载 .pkg 文件后,双击打开。
  2. 按照安装向导的提示,一路“继续”并同意许可协议。
  3. 默认安装路径为 /Library/Frameworks/Python.framework/Versions/3.12,建议不要修改。
  4. 安装完成后,打开“终端”(Terminal),输入:
    python3 --version
    
    注意macOS自带了Python 2.7,所以要用 python3 命令来区分。
    如果显示 Python 3.12.4,则安装成功。

3.2 使用Homebrew(推荐给开发者)

如果你已经安装了Homebrew(macOS的包管理器),可以一条命令搞定:

brew install python@3.12

安装完成后,Homebrew会自动将Python 3.12链接到 /usr/local/bin/python3,同样用 python3 --version 验证。

3.3 设置默认Python(可选)

如果你想在终端直接输入 python 就打开Python 3,可以修改 ~/.zshrc~/.bash_profile,添加别名:

alias python='python3'

然后执行 source ~/.zshrc 使其生效。


四、Linux系统下安装Python

Linux发行版众多,这里以Ubuntu/DebianCentOS/RHEL为例。

4.1 Ubuntu/Debian 使用 apt

Ubuntu 20.04+ 默认自带Python 3,但版本可能较旧。如果你想安装最新版,可以添加 deadsnakes PPA:

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev

安装完成后,使用 python3.12 --version 验证。

4.2 CentOS/RHEL 使用 yum

CentOS 8 默认自带Python 3.6,如需新版,可以通过EPEL或源码编译。这里推荐使用源码编译(更通用)。

4.3 源码编译安装(通用方法)

  1. 安装依赖:

    sudo yum groupinstall "Development Tools" -y
    sudo yum install openssl-devel bzip2-devel libffi-devel -y
    

    (Ubuntu对应:sudo apt install build-essential libssl-dev libbz2-dev libffi-dev

  2. 下载源码包:

    wget https://www.python.org/ftp/python/3.12.4/Python-3.12.4.tgz
    tar -xzf Python-3.12.4.tgz
    cd Python-3.12.4
    
  3. 编译安装:

    ./configure --enable-optimizations
    make -j $(nproc)
    sudo make altinstall
    

    注意使用 altinstall 避免覆盖系统自带的 python3 命令。

  4. 验证:

    python3.12 --version
    

五、验证安装与pip配置

5.1 基本验证

无论哪个系统,打开终端/命令提示符,执行:

python --version   # Windows 或设置了别名的Mac/Linux
python3 --version  # Mac/Linux

如果正确显示版本号,说明Python已可用。

5.2 检查pip并升级

pip是Python的包管理工具,用于安装第三方库。检查pip版本:

pip --version      # Windows
pip3 --version     # Mac/Linux

如果版本较低,可以升级:

python -m pip install --upgrade pip

5.3 配置pip镜像源(加速下载)

国内用户建议将pip源切换为清华或阿里云镜像,避免下载超时。

  • 临时使用:pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名
  • 永久配置:
    pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
    

5.4 创建虚拟环境(推荐)

为了隔离项目依赖,建议学习使用venv:

python -m venv myproject_env
source myproject_env/bin/activate   # Mac/Linux
myproject_env\Scripts\activate      # Windows

激活后,终端前缀会显示环境名称,表示已进入虚拟环境。


六、常见问题与解决方案(FAQ)

Q1:安装时忘记勾选“Add Python to PATH”怎么办?

  • Windows:手动添加环境变量。
    右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量 -> 在“系统变量”中找到 Path,双击编辑,添加两条:
    • C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\
    • C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\
      然后重新打开cmd即可生效。

Q2:提示“pip不是内部或外部命令”?

  • 通常是因为 Scripts 目录未加入PATH,同样按照上面方法添加 Scripts 路径。
  • 或者使用 python -m pip install 包名 来代替 pip install

Q3:Mac/Linux下输入python打开的是Python 2.x?

  • 因为系统默认 python 指向Python 2,你需要使用 python3 或设置别名(见第三节)。

Q4:Linux编译安装时提示缺少依赖?

  • 确保安装了 openssl-devellibffi-develzlib-devel 等开发包。参考第四节的依赖安装命令。

Q5:安装第三方库时遇到SSL错误?

  • 可能是Python编译时未正确链接OpenSSL,建议使用包管理器安装预编译版本,或者重新编译并指定SSL路径。

Q6:如何卸载Python?

  • Windows:控制面板 -> 程序和功能 -> 找到Python,卸载即可。
  • macOS:删除 /Library/Frameworks/Python.framework/usr/local/bin 中的符号链接。
  • Linux:若用包管理器安装,使用 sudo apt remove python3.12 等;若源码编译,直接删除安装目录(默认 /usr/local/lib/python3.12)并移除相关链接。

Happy Coding!🐍

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐