🪟 Windows 系统安装 Python

方法 1：官方安装包（推荐）

步骤：

1. 下载 Python

   bash

   # 访问 Python 官网：https://www.python.org/downloads/windows/
   # 下载最新版本（如 Python 3.11+）

2. 运行安装程序

   bash

   # 1. 双击下载的 .exe 文件
   # 2. 重要：勾选 "Add Python to PATH"（添加到环境变量）
   # 3. 选择 "Install Now" 或 "Customize installation"

3. 验证安装

   cmd

   # 打开命令提示符 (cmd)
   python --version
   # 或
   python -V
   
   pip --version

方法 2：Microsoft Store

1. 打开 Microsoft Store

2. 搜索 "Python"

3. 选择官方版本安装

4. 自动配置环境变量

方法 3：包管理器 Chocolatey

powershell

# 1. 安装 Chocolatey（以管理员身份运行 PowerShell）
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 2. 使用 Chocolatey 安装 Python
choco install python

# 3. 验证安装
python --version

🐧 Linux 系统安装 Python

方法 1：系统包管理器（推荐新手）

Ubuntu/Debian:

bash

# 更新包列表
sudo apt update

# 安装 Python 3
sudo apt install python3 python3-pip python3-venv

# 安装开发工具（可选）
sudo apt install python3-dev build-essential

# 验证安装
python3 --version
pip3 --version

CentOS/RHEL/Fedora:

bash

# CentOS/RHEL
sudo yum update
sudo yum install python3 python3-pip

# 或者使用 dnf（新版本）
sudo dnf install python3 python3-pip

# Fedora
sudo dnf install python3 python3-pip

Arch Linux:

bash

sudo pacman -S python python-pip

方法 2：使用 pyenv（推荐开发者）

安装 pyenv：

bash

# 1. 安装依赖
# Ubuntu/Debian
sudo apt update
sudo apt install make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-dev

# CentOS/RHEL
sudo yum install gcc zlib-devel bzip2 bzip2-devel readline-devel \
sqlite sqlite-devel openssl-devel tk-devel libffi-devel

# 2. 安装 pyenv
curl https://pyenv.run | bash

# 3. 添加到 shell 配置 (~/.bashrc, ~/.zshrc 等)
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

# 4. 重新加载配置
source ~/.bashrc

使用 pyenv：

bash

# 查看可安装的 Python 版本
pyenv install --list

# 安装特定版本
pyenv install 3.11.4

# 查看已安装版本
pyenv versions

# 设置全局版本
pyenv global 3.11.4

# 设置本地项目版本
pyenv local 3.10.12

# 验证
python --version

方法 3：从源码编译（高级用户）

bash

# 1. 安装编译依赖
sudo apt update
sudo apt install build-essential zlib1g-dev libncurses5-dev \
libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libsqlite3-dev wget libbz2-dev

# 2. 下载 Python 源码
cd /tmp
wget https://www.python.org/ftp/python/3.11.4/Python-3.11.4.tgz
tar -xf Python-3.11.4.tgz
cd Python-3.11.4

# 3. 配置和编译
./configure --enable-optimizations --prefix=/usr/local/python3.11
make -j $(nproc)
sudo make altinstall  # 使用 altinstall 避免覆盖系统 Python

# 4. 创建符号链接（可选）
sudo ln -s /usr/local/python3.11/bin/python3.11 /usr/local/bin/python3.11
sudo ln -s /usr/local/python3.11/bin/pip3.11 /usr/local/bin/pip3.11

🔧 安装后配置

1. 升级 pip

bash

# Windows
python -m pip install --upgrade pip

# Linux
python3 -m pip install --upgrade pip

2. 配置 pip 镜像源（国内用户）

bash

# 临时使用
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package

# 永久配置
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 或者创建配置文件
# Linux/Mac: ~/.pip/pip.conf
# Windows: %APPDATA%\pip\pip.ini

pip.conf 内容：

ini

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

3. 安装常用工具

bash

# 虚拟环境工具
pip install virtualenv virtualenvwrapper

# 开发工具
pip install ipython jupyter notebook black flake8 mypy

# 包管理工具
pip install pipenv poetry

🐍 虚拟环境使用

创建虚拟环境：

bash

# 方法 1: venv (Python 3.3+)
python -m venv myenv

# 方法 2: virtualenv
virtualenv myenv

# 方法 3: 指定 Python 版本
python3.11 -m venv myenv

激活虚拟环境：

bash

# Windows
myenv\Scripts\activate

# Linux/Mac
source myenv/bin/activate

停用虚拟环境：

bash

deactivate

🛠️ 故障排除

Windows 常见问题：

问题：'python' 不是内部或外部命令

cmd

# 解决方案：手动添加环境变量
# 1. 右键"此电脑" → 属性 → 高级系统设置
# 2. 环境变量 → 系统变量 → Path → 编辑
# 3. 添加 Python 安装路径（如：C:\Python311）
# 4. 添加 Scripts 路径（如：C:\Python311\Scripts）

问题：pip 命令不存在

cmd

# 确保安装时勾选了 "Install pip"
python -m ensurepip --default-pip

Linux 常见问题：

问题：Permission denied

bash

# 使用 sudo 或修改权限
sudo pip install package_name

# 或者更好的方法：使用用户安装
pip install --user package_name

问题：Python 版本冲突

bash

# 查看所有 Python 版本
ls /usr/bin/python*

# 设置替代版本（Ubuntu/Debian）
sudo update-alternatives --config python3

📊 版本选择建议

用途	推荐版本	说明
新项目	Python 3.11+	最新特性，最好性能
生产环境	Python 3.9-3.11	稳定，生态支持好
机器学习	Python 3.8+	框架兼容性好
旧项目维护	按项目要求	保持版本一致

✅ 验证安装成功

创建测试文件 test.py：

python

import sys

print(f"Python 版本: {sys.version}")
print(f"Python 路径: {sys.executable}")

# 测试常用功能
try:
    import requests
    print("✓ requests 库可用")
except ImportError:
    print("✗ requests 库未安装")

# 测试虚拟环境
print(f"虚拟环境: {hasattr(sys, 'real_prefix') or (hasattr(sys, 'base_prefix') and sys.base_prefix != sys.prefix)}")

运行测试：

bash

python test.py

🎯 总结

Windows 推荐：

• 新手：官方安装包 + "Add to PATH"

• 开发者：Chocolatey 或 Windows 子系统 Linux (WSL)

Linux 推荐：

• 普通用户：系统包管理器 (apt, dnf, yum)

• 开发者：pyenv（多版本管理）

• 高级用户：源码编译

无论选择哪种方式，都建议：

1. 配置虚拟环境用于项目隔离

2. 设置国内镜像源加速下载

3. 定期更新 pip和工具链

4. 使用版本控制管理项目依赖

这样就能获得一个稳定、高效的 Python 开发环境！