Skip to main content

环境与运行

本模块基于 Python 3.10+。先把解释器装好，再学会怎么跑代码。

安装​

  • macOS：可用官网安装包，或 brew install python
  • Windows：官网安装包，勾选 Add Python to PATH
  • Linux：发行版包管理器（注意系统自带的 python3 版本是否 ≥ 3.10）

安装后在终端检查：

python3 --version
# 期望类似：Python 3.10.x / 3.11.x / 3.12.x

部分环境命令名是 python 而不是 python3，以本机为准。

需要在本机同时维护 3.10 / 3.12 等多个解释器时，见进阶「多版本管理」。

REPL（交互式解释器）​

python3

进入后可直接输入表达式：

>>> 1 + 1
2
>>> print("hello")
hello

退出：exit() 或 Ctrl-D（Windows 上常为 Ctrl-Z + Enter）。

运行脚本​

新建 hello.py：

print("hello, python")

执行：

python3 hello.py

pip 初识​

pip 是 Python 官方生态里最常见的包安装器（建议之后配合虚拟环境，见进阶章节）：

python3 -m pip --version
python3 -m pip install requests

优先使用 python3 -m pip，避免装到错误的 Python 上。

读文档、跟教程时你会大量看到 pip；能读懂它仍然很重要。

uv 初识（推荐）​

uv 是 Astral 出品的 Python 包与项目管理工具（Rust 实现）。它提供两套用法：

  • 兼容接口：uv pip / uv venv —— 接近传统 pip + venv，迁移成本低
  • 项目接口：uv init / uv add / uv sync / uv run —— 用 pyproject.toml + 锁文件管整个项目（进阶展开）

安装（任选其一）：

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# macOS（Homebrew）
brew install uv

# Windows（PowerShell）
# powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

兼容 pip 的装包示例（需先有虚拟环境）：

uv pip install requests

工具对比（uv / pip / 相关）​

工具主要职责备注
pip安装包到当前环境标准、教程最多；本身不管虚拟环境
venv / virtualenv创建隔离的虚拟环境标准库有 venv；virtualenv 是第三方增强
pip-tools从需求文件解析并锁版本传统「可复现安装」方案之一
Poetry 等项目依赖 + 环境 + 打包一体功能全，学习/迁移成本更高
uv可覆盖上述多数流程更快；一个工具同时提供 pip 兼容与项目级接口

粗规则：

  1. 读旧教程 / 维护旧仓库：会认 pip + venv 即可
  2. 新项目 / 本机日常：优先 uv（uv init / uv add / uv run）
  3. 暂时不想改工作流：把 pip 换成 uv pip、python -m venv 换成 uv venv，通常就能先吃到速度红利

常用命令对照​

目的传统uv（兼容接口）uv（项目接口）
创建虚拟环境python3 -m venv .venvuv venvuv init 后自动管环境
安装包python -m pip install requestsuv pip install requestsuv add requests
按列表安装pip install -r requirements.txtuv pip install -r requirements.txtuv sync（按锁文件）
跑脚本python app.py（需先 activate）同左（activate 后）uv run app.py

注意：uv pip ... 仍面向「当前/指定虚拟环境」；uv add / uv sync 面向「整个项目」，会改 pyproject.toml 与锁文件。

项目级依赖声明、锁文件与日常约定，见进阶「项目与包管理」。

要点​

  1. 确认版本 ≥ 3.10
  2. 会用 REPL 试一小段代码
  3. 会用 python3 xxx.py 跑脚本
  4. 分清：pip 只管装包；venv 管隔离；uv 可两者都管
  5. 新项目优先 uv；旧流程可用 uv pip 平滑替换