序言

本教程由「小荣的网络开发日志」实操整理编写，实操踩坑验证，内容真实可靠。

遇到操作问题可直接联系作者，转载需标注原文出处，禁止私自篡改商用。

承接网站、APP、小程序、各类脚本定制开发；

AI 编程教学、一对一项目全程陪跑，提供免费技术咨询。

联系方式： 微信：rongyaolg 电话：18375295913

这篇适合谁

如果你准备做 AI 调用、数据处理、自动化脚本、爬虫、FastAPI / Django 后端，就需要安装 Python。

如果你现在只做前端网站、小程序、Astro / React / Vue 项目，可以先装 Node.js，Python 按需再装。

先选哪个版本

新手原则很简单：

• 优先去 Python 官网下载当前稳定版
• Windows 用户可以使用官网推荐的 Python install manager，也可以下载 64-bit installer
• 项目教程如果明确写了版本，比如 Python 3.11 或 3.12，就按教程要求安装
• 不要安装 Python 2，它已经不适合新项目

官网入口：

• Python 下载页：https://www.python.org/downloads/
• Windows 下载页：https://www.python.org/downloads/windows/

Windows 安装步骤

1. 打开 Python 官网下载页
2. 点击下载 Windows 版本
3. 运行安装器
4. 在安装器第一页勾选 Add python.exe to PATH
5. 点击 Install Now
6. 安装完成后打开 PowerShell，执行：

复制python --version
pip --version

如果你的电脑提示 python 找不到，再试：

复制py --version
py -m pip --version

能看到版本号，就说明 Python 和 pip 已经可用。

macOS 安装步骤

macOS 有两种常见方式。

方式一：官网下载

1. 打开 https://www.python.org/downloads/
2. 下载 macOS installer
3. 双击安装
4. 打开终端验证：

复制python3 --version
pip3 --version

方式二：Homebrew 安装

如果你已经安装 Homebrew，可以直接执行：

复制brew install python
python3 --version
pip3 --version

新手如果不知道 Homebrew 是什么，用官网下载方式就够了。

Linux 安装步骤

大多数 Linux 发行版已经自带 Python。先检查：

复制python3 --version
pip3 --version

Ubuntu / Debian 可以这样安装：

复制sudo apt update
sudo apt install -y python3 python3-pip python3-venv

Fedora 可以这样安装：

复制sudo dnf install -y python3 python3-pip

Arch Linux 可以这样安装：

复制sudo pacman -S python python-pip

第一次运行 Python

新建一个文件 hello.py：

复制print("Hello Python")

运行：

复制python hello.py

如果是 macOS / Linux，通常使用：

复制python3 hello.py

看到 Hello Python，说明 Python 能正常运行。

学会创建虚拟环境

虚拟环境用来把每个项目的依赖隔离开，避免 A 项目装的包影响 B 项目。

在项目目录执行：

复制python -m venv .venv

Windows 激活：

复制.venv\Scripts\activate

macOS / Linux 激活：

复制source .venv/bin/activate

激活后安装一个测试包：

复制pip install requests
python -c "import requests; print(requests.__version__)"

退出虚拟环境：

复制deactivate

常见问题

python 不是内部或外部命令

Windows 安装时没有勾选 PATH。解决方式：

1. 重新运行 Python 安装器
2. 选择 Modify
3. 勾选添加到 PATH，或重新安装时勾选 Add python.exe to PATH
4. 关闭并重新打开 PowerShell

也可以先用：

复制py --version

pip 找不到

先试：

复制python -m pip --version

macOS / Linux 试：

复制python3 -m pip --version

如果还是不行，说明 pip 没装好。Linux 上通常需要额外安装 python3-pip。

python 和 python3 到底用哪个

Windows 常用 python 或 py。

macOS / Linux 常用 python3。

如果教程命令和你电脑不同，不要慌，先用版本命令确认哪个能跑，再把教程里的 python 替换成你电脑可用的命令。

安装完成检查清单

• 能看到 Python 版本号
• 能看到 pip 版本号
• 能运行 hello.py
• 能创建并激活 .venv
• 能用 pip 安装包

这五项都通过，Python 环境就可以用于 AI 项目、脚本项目和 Python 后端项目了。