机器学习与深度学习 / 系统课时

安装 Python 开发环境

安装 Python 开发环境

本课完成一套可复用的 Python 项目环境:安装受支持的解释器,确认 pip 可用,为项目创建独立虚拟环境,并把依赖版本写入文件。完成后,不同项目之间不会互相污染,也能在另一台电脑上复现相同环境。

学习目标

  • 正确安装并验证 64 位 Python 与 pip
  • 使用 venv 为项目隔离解释器和第三方包
  • 导出依赖清单并验证环境能够重新创建

理解开发环境的组成

一个可维护的 Python 项目通常包含四部分:系统中的 Python 解释器、项目目录内的虚拟环境、由 pip 安装的第三方包,以及记录版本的 requirements.txt。运行项目时应先激活虚拟环境,再安装或执行代码,避免把依赖直接写入全局 Python。

Python 项目环境组成

安装时优先选择仍受 PyTorch 支持的 64 位 Python 版本。课程项目建议使用 Python 3.11 或 3.12;若官网的 PyTorch 安装页给出不同兼容范围,应以页面当前提示为准。

安装并验证 Python

Windows 可从 Python 官方网站安装,并确保安装器允许在终端中使用 Python;macOS 与 Linux 可使用系统包管理器或官方安装包。安装完成后重新打开终端,再执行验证命令。Windows PowerShell:

powershell
py --version
py -m pip --version

预期输出:

text
Python 3.<MINOR>.<PATCH>
pip <VERSION> from <PATH> (python 3.<MINOR>)

macOS 或 Linux:

bash
python3 --version
python3 -m pip --version

预期输出:

text
Python 3.<MINOR>.<PATCH>
pip <VERSION> from <PATH> (python 3.<MINOR>)

实际的小版本、补丁版本和安装路径会不同。若终端提示找不到命令,先关闭并重新打开终端;仍无效时,检查 Python 是否安装成功以及命令目录是否加入系统环境变量。

创建并激活虚拟环境

在准备存放代码的位置创建项目目录,然后用当前解释器生成名为 .venv 的虚拟环境。.venv 只服务于当前项目,不应提交到 Git 仓库。Windows PowerShell:

powershell
mkdir pytorch-course
cd pytorch-course
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip

预期输出:

text
Requirement already satisfied: pip in <PATH>

如果 pip 有可用更新,输出会显示卸载旧版本并安装新版本,最终不应出现错误。终端提示符通常会出现 (.venv)。macOS 或 Linux:

bash
mkdir -p pytorch-course
cd pytorch-course
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

预期输出:

text
Requirement already satisfied: pip in <PATH>

退出环境时执行 deactivate。下次进入项目后,只需重新运行对应平台的激活命令,不必再次创建 .venv。

安装并固定项目依赖

先安装一个轻量依赖,用它验证包确实进入当前虚拟环境,再导出完整版本清单。

bash
python -m pip install numpy
python -m pip freeze > requirements.txt
python -m pip show numpy

预期输出:

text
Name: numpy
Version: <VERSION>
Location: <PROJECT_PATH>/.venv/<PATH>

关键是 Location 指向项目中的 .venv。以后在新电脑或新虚拟环境中,可执行 python -m pip install -r requirements.txt 恢复相同版本。Python Packaging 指南也建议使用 venv 与依赖文件隔离、复现项目环境。:contentReference[oaicite:0]{index=0}

处理常见安装失败

当 PowerShell 阻止激活脚本时,可为当前用户设置合适的执行策略,或直接使用 .venv\Scripts\python.exe 执行命令。Linux 若提示缺少 venv 模块,应通过发行版包管理器安装对应的 python3-venv 软件包。

如果 pip show numpy 的路径不在 .venv 中,说明命令使用了错误的解释器。先执行 deactivate,重新激活环境,再统一使用 python -m pip,不要混用全局 pip、pip3 和虚拟环境中的 pip。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Python 开发环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通