Python 从下载安装到开发环境配置（保姆级教程）

本文适合零基础读者，涵盖 Windows、macOS、Linux的安装、验证、pip、虚拟环境以及 VS Code 配置。

1. Python 是什么？

Python 是一种简单、易学、跨平台的编程语言，可用于：

  •   自动化办公

  •   数据分析

  •   AI 与机器学习

  •   爬虫

  •   Web 开发

  •   运维脚本

  •   游戏开发

官方网站：

https://www.python.org/

2. 下载 Python

进入官网：

https://www.python.org/downloads/

官网会自动推荐当前系统版本。

建议安装最新版稳定版。

3. Windows 安装

第一步

点击 Download Python。

下载完成后双击安装程序。

第二步

一定勾选

☑ Add python.exe to PATH

这是最容易漏掉的一步。

然后点击：

Install Now

等待安装完成。

第三步

打开 CMD：

Win + R

输入：

1
2


cmd

输入：

1
2


python --version

或者：

1
2


py --version

看到版本号说明安装成功。

继续：

1
2


pip --version

如果显示版本号，pip 已正常安装。

4. macOS 安装

推荐方法一：

官网下载 pkg 安装包。

推荐方法二（开发者）：

安装 Homebrew：

1
2


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

安装 Python：

1
2


brew install python

验证：

1
2
3
4


python3 --version

pip3 --version

Apple Silicon 用户建议使用 python3 命令。

5. Linux 安装

Ubuntu / Debian

1
2
3
4


sudo apt update

sudo apt install python3 python3-pip -y

验证：

1
2
3
4


python3 --version

pip3 --version

Fedora

1
2


sudo dnf install python3 python3-pip

CentOS / Rocky

1
2


sudo dnf install python3 python3-pip

Arch Linux

1
2


sudo pacman -S python python-pip

6. 环境变量

PATH 用于告诉系统去哪里寻找 python.exe。

如果忘记勾选 PATH：

Windows：

设置

→ 系统

→ 高级系统设置

→ 环境变量

把 Python 安装目录添加到 Path。

通常类似：

1
2


C:\Users\用户名\AppData\Local\Programs\Python\Python313\

以及：

1
2


...\Scripts\

7. pip

升级 pip：

1
2


python -m pip install --upgrade pip

Linux/macOS：

1
2


python3 -m pip install --upgrade pip

安装第三方库：

1
2


pip install requests

查看：

1
2


pip list

卸载：

1
2


pip uninstall requests

8. 国内镜像

例如清华镜像：

1
2


pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

查看：

1
2


pip config list

9. 第一个程序

新建 hello.py：

1
2


print("Hello World!")

运行：

Windows：

1
2


python hello.py

Linux/macOS：

1
2


python3 hello.py

10. VS Code

安装：

  •   VS Code

  •   Python 扩展

打开项目。

Ctrl+Shift+P

输入：

Python: Select Interpreter

选择刚安装的 Python。

11. 虚拟环境

创建：

1
2


python -m venv .venv

Windows 激活：

1
2


.venv\Scripts\activate

macOS/Linux：

1
2


source .venv/bin/activate

退出：

1
2


deactivate

12. 常见问题

python 不是内部命令

原因：

  •   PATH 未配置

  •   未重启终端

pip 找不到

尝试：

1
2


python -m pip --version

Permission denied

Linux：

1
2


sudo

不要长期使用 sudo 安装第三方库，优先使用虚拟环境。

13. 总结

完成以下检查：

  •   Python 已安装

  •   pip 可用

  •   VS Code 可识别解释器

  •   Hello World 成功运行

  •   会创建虚拟环境

  •   会安装第三方库

至此，一个完整的 Python 开发环境已经搭建完成。