本文档仅针对新手，如您已安装python，可直接跳过

概述

Python 3 是一种高级编程语言，以其简洁的语法和强大的功能而闻名。本指南将帮助您在不同操作系统上安装Python 3，并配置开发环境。

重要提示：Python 2 已于2020年停止支持，建议所有新项目都使用Python 3。

主要特性

  • 简洁易读的语法
  • 丰富的标准库
  • 跨平台兼容性
  • 强大的第三方库生态
  • 活跃的社区支持

Windows 系统安装

访问 Python官网 下载页面
下载最新版本的Python 3.x安装包（.exe文件）
Python官网下载页面
运行安装程序，务必勾选"Add Python to PATH"选项
Python安装时添加PATH选项
选择"Install Now"进行标准安装
等待安装完成，验证安装是否成功
安装成功：安装完成后，您可以在命令提示符或PowerShell中使用python命令。

macOS 系统安装

方法一：官方安装包

访问 Python macOS下载页面
下载适合您Mac型号的安装包（Intel或Apple Silicon）
双击.pkg文件运行安装程序
按照安装向导完成安装

方法二：Homebrew（推荐）

# 安装Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 使用Homebrew安装Python
brew install python

# 验证安装
python3 --version

方法三：pyenv版本管理

# 安装pyenv
brew install pyenv

# 安装最新版本的Python
pyenv install 3.11.0

# 设置全局Python版本
pyenv global 3.11.0

# 添加到shell配置文件
echo 'export PATH="$HOME/.pyenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

Linux 系统安装

Ubuntu/Debian

# 更新包列表
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

# CentOS/RHEL 8+
sudo dnf install python3 python3-pip

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

# Fedora
sudo dnf install python3 python3-pip

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

Arch Linux

# 安装Python
sudo pacman -S python python-pip

# 验证安装
python --version
pip --version

从源码编译安装

# 下载源码
wget https://www.python.org/ftp/python/3.11.0/Python-3.11.0.tgz
tar -xzf Python-3.11.0.tgz
cd Python-3.11.0

# 配置编译选项
./configure --enable-optimizations

# 编译安装
make -j 8
sudo make altinstall

# 验证安装
python3.11 --version

验证安装

检查Python版本

# 检查Python版本
python --version
# 或者
python3 --version

# 检查pip版本
pip --version
# 或者
pip3 --version

运行Python解释器

# 启动Python交互式环境
python
# 或者
python3

# 在Python解释器中测试
>>> print("Hello, Python!")
Hello, Python!
>>> import sys
>>> print(sys.version)
3.11.0 (main, Oct 24 2022, 10:07:16) [GCC 9.4.0]
>>> exit()

创建虚拟环境

# 创建虚拟环境
python -m venv myenv
# 或者
python3 -m venv myenv

# 激活虚拟环境
# Windows
myenv\Scripts\activate

# macOS/Linux
source myenv/bin/activate

# 验证虚拟环境
which python
pip list

# 退出虚拟环境
deactivate
恭喜！如果您能看到Python版本信息，说明安装成功。

开发环境配置

推荐IDE和编辑器

  • PyCharm：专业的Python IDE，功能强大
  • Visual Studio Code：轻量级编辑器，插件丰富
  • Sublime Text：快速、轻量的文本编辑器
  • Vim/Neovim：命令行编辑器，适合高级用户

常用包管理工具

# 升级pip
python -m pip install --upgrade pip

# 安装常用包
pip install requests numpy pandas matplotlib

# 从requirements.txt安装
pip install -r requirements.txt

# 生成requirements.txt
pip freeze > requirements.txt

环境变量配置

  • Windows
  • macOS
  • Linux
# 添加到系统环境变量
setx PATH "%PATH%;C:\Python311;C:\Python311\Scripts"

# 或者在系统属性中手动添加
# 控制面板 -> 系统 -> 高级系统设置 -> 环境变量
# 在PATH变量中添加Python安装路径
# 编辑 ~/.zshrc 或 ~/.bash_profile
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc

# 重新加载配置
source ~/.zshrc
# 编辑 ~/.bashrc 或 ~/.profile
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
echo 'export PYTHONPATH="/usr/local/lib/python3.11/site-packages:$PYTHONPATH"' >> ~/.bashrc

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

常见问题

Q: 安装后提示"python不是内部或外部命令"？

A: 这是PATH环境变量未配置的问题：

  • 重新运行安装程序，确保勾选"Add Python to PATH"
  • 手动添加Python安装路径到系统PATH环境变量
  • 重启命令提示符或PowerShell

Q: 如何同时安装多个Python版本？

A: 推荐使用版本管理工具：

  • pyenv：适用于macOS和Linux
  • pyenv-win：适用于Windows
  • conda：跨平台，支持虚拟环境

Q: pip安装包时提示权限错误？

A: 使用以下方法解决：

  • 使用虚拟环境：python -m venv myenv
  • 使用用户安装：pip install --user package_name
  • 使用sudo（Linux/macOS）：sudo pip install package_name

Q: 如何卸载Python？

A: 不同系统的卸载方法：

  • Windows：控制面板 -> 程序和功能 -> 卸载Python
  • macOS：删除/Applications/Python 3.x文件夹
  • Linux：sudo apt remove python3（Ubuntu）

Q: Python安装后如何更新？

A: 更新方法：

  • 下载新版本安装包，覆盖安装
  • 使用包管理器更新（如brew upgrade python）
  • 使用pyenv安装新版本并切换

Q: 如何解决SSL证书问题？

A: 常见解决方案：

  • 更新证书：pip install --upgrade certifi
  • 使用国内镜像：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name
  • 临时忽略SSL：pip install --trusted-host pypi.org --trusted-host pypi.python.org package_name

下一步

安装完成后，您可以：

  • 学习Python基础语法
  • 安装常用的第三方库
  • 配置开发环境
  • 开始您的第一个Python项目

推荐学习资源

需要帮助？

如果您在安装过程中遇到问题，可以通过以下方式获取帮助：