官网:www.xservx.com 备案号:蜀ICP备2026035467号-3

python安装教程(非常详细)

python安装教程(非常详细)|全平台安装指南+实战配置+避坑手册

本python安装教程(非常详细)面向零基础及进阶用户,提供从官网下载、安装、环境变量配置、多版本共存、虚拟环境搭建到故障排查的全流程解决方案。全文超过3000字,涵盖Windows、macOS、Linux三大主流平台,结合真实配置截图说明、命令行示例、常见错误解析,助您高效完成Python环境部署,避免90%以上新手踩坑。

本教程严格遵循Python官方文档规范,整合社区高频问题,特别强化环境变量、版本管理、虚拟环境隔离三大核心环节的实操指导,确保您不仅“能装”,更能“装得对、用得好”。所有步骤均经Python 3.12.3实测验证,兼容3.7~3.13各版本。

本教程特色

  • ⚡ 实操性:每步操作均提供可复制命令与关键参数说明
  • ⚙️ 系统性:覆盖安装→配置→验证→进阶→排错全链路
  • 〔〕 结构化:采用模块化设计,支持按需查阅
  • 〈〉 示例性:含完整代码片段与错误日志分析

一、Windows平台安装(含Python 3.12.3实操)

1.1 官网下载与安装包选择

访问Python官网(https://www.python.org/downloads/windows/),下载最新稳定版(当前为Python 3.12.3)。请务必选择Windows installer下的64-bit executable installer(除非使用32位系统)。

⚠️ 注意:不要下载“Web-based installer”,该版本需联网下载组件,易因网络中断失败;也不推荐“Embedded zip file”,该版本为便携式,不提供系统级集成。

下载命名规则解析

  • python-3.12.3-amd64.exe:64位系统推荐安装包
  • python-3.12.3.exe:自动检测系统位数(推荐新手)
  • python-3.12.3-amd64-debug.exe:仅开发调试使用

1.2 安装过程关键步骤(图文说明)

双击安装包后,进入Python Setup界面:

  1. 勾选Add Python 3.12 to PATH(必须!避免后续环境变量配置)
  2. 点击Customize installation(自定义安装)
  3. 在“Optional Features”中建议勾选:
    • pip(包管理器)
    • tkinter(GUI开发库)
    • py launcher(多版本管理工具)
  4. 点击“Next”,在“Advanced Options”中:
  5. 勾选Install for all users(多用户系统推荐)
  6. 将Install to路径改为非系统盘(如D:\Python312),避免权限问题
  7. 点击“Install”等待完成

验证安装成功

按Win+R输入cmd回车,执行:

python --version
Python 3.12.3
pip --version
pip 24.0 from D:\Python312\Lib\site-packages\pip (python 3.12)

1.3 环境变量手动补全方案(若安装时未勾选)

若安装时未勾选“Add to PATH”,需手动配置:

  1. 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”
  2. 在“系统变量”区域找到Path,点击“编辑”
  3. 点击“新建”,添加:
    • D:\Python312\
    • D:\Python312\Scripts\
  4. 点击“确定”保存,重启终端生效

常见错误:'python' 不是内部或外部命令

原因:PATH未包含Python路径或拼写错误(如pythpn)

解决:检查路径是否包含\Scripts\,并确保使用python而非python3(Windows默认命令为python)

二、macOS平台安装(Homebrew与官方包双方案)

2.1 方案一:使用Homebrew(推荐开发者)

Homebrew是macOS包管理器,支持一键安装与版本升级:

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

默认安装最新稳定版(当前为Python 3.12.3),安装路径为/opt/homebrew/bin/python3(Apple Silicon)或/usr/local/bin/python3(Intel)。

验证与路径检查

which python3
/opt/homebrew/bin/python3
python3 --version
Python 3.12.3

2.2 方案二:官方安装包(适合保守用户)

  1. 下载macOS 64-bit universal2 installer(兼容Apple Silicon与Intel)
  2. 双击安装包,按向导完成安装(路径:/Library/Frameworks/Python.framework/Versions/3.12)
  3. 安装完成后,终端执行:
    • python3 --version → 显示Python 3.12.3
    • pip3 --version → 验证包管理器

2.3 macOS特有问题:Command Line Tools依赖

首次运行Python可能报错:ModuleNotFoundError: No module named '_ctypes'

原因:缺少Apple Command Line Tools

解决:

xcode-select --install

等待安装完成后重试。

三、Linux平台安装(Ubuntu/Debian/CentOS实操)

3.1 Ubuntu/Debian系列

更新包索引后安装:

sudo apt update && sudo apt install python3 python3-pip -y

验证版本:

python3 --version
Python 3.12.3
pip3 --version
pip 24.0 from /usr/lib/python3/dist-packages/pip (python 3.12)

注意:Python 3.12需手动编译

Ubuntu 22.04默认提供Python 3.10,若需3.12,请使用deadsnakes PPA:

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

3.2 CentOS/RHEL系列

CentOS 7默认Python为2.7,需安装Python 3:

sudo yum install centos-release-scl -y
sudo yum install rh-python38 -y

启用新版本:

scl enable rh-python38 bash
python --version
Python 3.8.18

源码编译安装(终极方案)

wget https://www.python.org/ftp/python/3.12.3/Python-3.12.3.tgz
tar -xf Python-3.12.3.tgz
cd Python-3.12.3
./configure --enable-optimizations --prefix=/opt/python312
make -j$(nproc)
sudo make altinstall

安装后路径:/opt/python312/bin/python3.12,避免覆盖系统自带Python

四、环境变量配置深度指南

4.1 核心路径说明

平台Python安装路径Scripts路径
WindowsC:\Python312C:\Python312\Scripts
macOS (Homebrew)/opt/homebrew/opt/python@3.12/bin/opt/homebrew/opt/python@3.12/bin
Linux (Ubuntu)/usr/bin/usr/bin

4.2 Windows环境变量配置步骤

  1. 打开“系统属性”→“环境变量”
  2. “用户变量”中新建PYTHONPATH,值为项目目录(如D:\Projects\PyLib)
  3. 在Path中添加:
    • %PYTHONPATH%
    • %USERPROFILE%\AppData\Roaming\Python\Python312\Scripts(用户级pip包路径)

验证环境变量

在任意目录新建test.py:

import sys
print(sys.path)

运行后应包含D:\Projects\PyLib等自定义路径

五、多版本Python共存方案

5.1 Windows:py launcher(Python启动器)

安装时勾选“Install for all users”后,系统自动安装py命令。使用方式:

py -3.12 --version
Python 3.12.3
py -3.11 --version
Python 3.11.9
py -3.10 -m pip install requests

设置默认版本

在%APPDATA%\py.ini中添加:

[defaults]
python=3.12

5.2 macOS/Linux:pyenv工具

安装pyenv:

curl https://pyenv.run | bash

在~/.bashrc或~/.zshrc中添加:

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

重新加载配置:

source ~/.zshrc

常用命令:

pyenv install 3.11.9
pyenv install 3.12.3
pyenv global 3.12.3
pyenv local 3.11.9  # 当前目录生效

常见错误:pyenv: command not found

原因:PATH未包含~/.pyenv/bin

解决:检查shell配置文件是否正确加载

六、虚拟环境搭建与管理

6.1 venv(官方方案)

创建虚拟环境:

python -m venv myenv

激活环境:

退出环境:deactivate

6.2 pipenv(高级管理)

安装:

pip install pipenv

创建虚拟环境:

pipenv --python 3.12
pipenv install requests

激活:

pipenv shell

虚拟环境优势

  • 〈〉 项目依赖隔离:避免全局污染
  • 《》 版本精确控制:每个项目独立依赖树
  • 【】 可复现环境:生成Pipfile.lock锁定版本

七、故障排查手册(高频问题+解决方案)

安装失败
模块缺失
权限问题

1. 安装时卡在“Compiling...”

原因:Windows Defender实时防护干扰

解决:临时关闭“实时保护”或添加安装路径到排除列表

2. macOS报错:“python3.12: command not found”

原因:Homebrew未链接

解决:

brew link python@3.12

3. Linux编译报错:“ModuleNotFoundError: No module named '_ssl’”

原因:缺少SSL开发库

解决:

sudo apt install libssl-dev libffi-dev

1. pip安装报错:“SSL: CERTIFICATE_VERIFY_FAILED”

原因:系统时间不正确或CA证书过期

解决:

  • Windows:运行certutil -generateSSTFromWU roots.sst
  • macOS:使用/Applications/Python 3.12/Install Certificates.command

2. pip install requests失败:“No matching distribution found”

原因:Python版本过低(如3.6已停止支持)

解决:升级Python至3.8+

1. Windows:PermissionError: [WinError 5] 拒绝访问

原因:未以管理员身份运行终端

解决:右键“命令提示符”→“以管理员身份运行”

2. Linux:pip install报错:“Cannot uninstall 'requests'”

原因:系统包与pip包冲突

解决:

pip install --ignore-installed requests