Python 开发环境搭建与常用命令

从零装好 Python 环境、掌握最常用的命令，并在 IntelliJ IDEA 中跑通 Python 开发。一套流程走完，环境丝滑无痛。

---

一、环境安装

1.1 安装 Python 本体

1. 到 python.org 下载对应系统的安装包（Windows 选 Windows installer）
2. 安装时务必勾选 Add python.exe to PATH，否则命令行找不到 python
3. 装完验证：

python --version
# 输出如：Python 3.13.12
pip --version

1.2 安装 uv（强烈推荐）

uv 是新一代 Python 包管理器——速度快、隔离干净、还能管 Python 版本，日常开发优先用它，pip 当兼容备胎。

# Windows
winget install astral-sh.uv

# 或任选其一
pip install uv

验证：uv --version

1.3 用 uv 管理多版本 Python（免手动装解释器）

uv python install 3.12      # 装指定版本
uv python list              # 看已装版本
uv python pin 3.12          # 项目锁定版本

---

二、虚拟环境（每个项目隔离依赖，必备）

⚠️ 别用系统 Python 全局 pip install，一律进虚拟环境，避免依赖版本互相污染。

方式	命令
pip 创建	python -m venv .venv
Windows 激活	.venv\Scripts\activate
uv 创建（推荐）	uv venv

---

三、常用命令速查

3.1 包管理

操作	pip	uv
安装	pip install requests	uv pip install requests
卸载	pip uninstall requests	uv pip uninstall requests
查看已装	pip list	uv pip list
查看详情	pip show requests	uv pip show requests

3.2 依赖清单

pip freeze > requirements.txt   # 导出当前环境依赖
pip install -r requirements.txt # 在别的机器复原环境

💡 pip freeze 会把系统级包一起带出来，一定要在 venv 里执行才干净。

3.3 运行脚本 / 交互

python app.py               # 跑脚本
python -i                   # 交互式 REPL
python -m http.server 8000  # 临时静态服务（常用小技巧）

---

四、IntelliJ IDEA 配置 Python 支持

4.1 前提

Python 插件只有 IDEA Ultimate 有，Community 社区版装不了，需要改用 PyCharm。

4.2 安装插件（一次性）

1. File → Settings（Ctrl+Alt+S）→ Plugins
2. 切到 Marketplace 标签，搜 Python（JetBrains 官方）
3. Install → 重启 IDEA

4.3 配置解释器

方式 A：新建 Python 项目（最省事）

1. File → New → Project，项目类型选 Python
2. 环境类型选 uv（IDEA 自动检测，或手动指定 uv 可执行文件）
3. 基础解释器选 Python 版本 → Create

方式 B：现有项目加 Python SDK

1. Ctrl+Alt+Shift+S 打开 Project Structure → SDKs → + → Add Python SDK → From Disk...
2. 环境类型选 uv：新建环境（选基础解释器）或复用已有 .venv
3. OK

支持的环境类型：虚拟环境 venv、uv、conda、Poetry、Hatch、Docker 等。

4.4 验证

• 右下角状态栏显示解释器（如 Python 3.13 (.venv)）
• .py 文件有语法高亮、自动补全
• 右键文件 → Run 能直接跑

---

五、常见问题

问题	解决
python 命令不识别	检查安装时是否勾选 Add to PATH
依赖装到全局、项目之间互相污染	一律用虚拟环境
pip freeze 带出一堆系统包	在 venv 里执行
换机器 / 克隆项目打开没解释器	IDEA 提示时选 uv 环境，一步到位
项目有 pyproject.toml / requirements.txt	直接用 uv 或 pip 安装依赖即可

---

六、一句话总结

uv 管环境、venv 隔离、IDEA 选 uv 解释器——三步走，Python 开发环境丝滑配好。有 pyproject.toml 或 requirements.txt 的项目，克隆下来选个解释器就能跑。