计算机视觉 / 系统课时

安装 Python 环境

安装 Python 环境

本课完成 YOLOv8 项目的 Python 基础环境搭建。你将安装 Python 3.10 或以上版本,创建独立虚拟环境,并通过版本与路径检查确认项目不会误用系统中的其他解释器。

学习目标

  • 在 Windows、macOS 或 Ubuntu 上安装可用的 Python 3
  • 使用 venv 为 YOLOv8 项目隔离依赖
  • 验证 python、pip 与虚拟环境路径是否一致

安装前先检查现有版本

先打开 PowerShell 或终端检查 Python 是否已经存在。不同系统的启动命令可能不同,只需执行与当前平台对应的一组。

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

预期输出如下,具体补丁版本和安装路径可能不同:

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

Windows 也可以使用 Python Launcher:

powershell
py --version
py -0p

预期输出会列出已安装解释器,实际版本和路径可能不同:

text
Python 3.<MINOR>.<PATCH>
 -V:3.<MINOR> *        <PATH>\python.exe

如果版本低于 3.10、命令不存在或路径指向不准备使用的解释器,再执行安装。

在当前系统安装 Python

Windows 建议使用 Python 官方安装程序。安装首页先勾选“Add python.exe to PATH”,再选择默认安装或自定义目录;安装完成后关闭并重新打开 PowerShell,让新的环境变量生效。

macOS 已安装 Homebrew 时,可以安装一个明确版本:

bash
brew install python@3.11
python3.11 --version

预期输出如下,补丁版本以实际安装结果为准:

text
Python 3.11.<PATCH>

Ubuntu 可使用系统包管理器安装 Python、venv 和 pip:

bash
sudo apt update
sudo apt install -y python3 python3-venv python3-pip
python3 --version

预期结果是安装命令正常结束,并输出 3.10 或以上版本:

text
Python 3.<MINOR>.<PATCH>

如果发行版仓库提供的版本低于项目要求,应改用新版发行版、pyenv 或经过维护的可信软件源,不要覆盖系统自带 Python。

创建项目虚拟环境

进入准备存放项目的目录,再创建名为 .venv 的虚拟环境。Windows PowerShell 使用以下命令:

powershell
mkdir yolov8-practice
cd yolov8-practice
py -3.10 -m venv .venv
.\.venv\Scripts\Activate.ps1
python --version

预期结果是命令提示符前出现 (.venv),并显示所选解释器版本:

text
Python 3.10.<PATCH>

如果本机安装的是其他 3.10 以上版本,把 -3.10 改为对应版本。macOS 或 Linux 使用以下命令:

bash
mkdir -p yolov8-practice
cd yolov8-practice
python3 -m venv .venv
source .venv/bin/activate
python --version

预期结果同样是终端前出现 (.venv),并输出虚拟环境中的 Python 版本:

text
Python 3.<MINOR>.<PATCH>

虚拟环境目录只服务于当前项目,不应提交到 Git。后续安装的 YOLOv8、PyTorch 和其他依赖都会写入 .venv,避免污染系统环境或其他项目。

升级并验证 pip

激活虚拟环境后,用当前解释器调用 pip,这样可以避免 pip 与 python 指向不同安装位置。

bash
python -m pip install --upgrade pip
python -m pip --version
python -c "import sys; print(sys.executable)"

预期输出中的 Python 路径应位于当前项目的 .venv 目录,版本号和绝对路径会因系统而不同:

text
pip <VERSION> from <PATH>/.venv/<PATH> (python 3.<MINOR>)
<PATH>/.venv/<PATH>/python

Windows 路径通常以 .venv\Scripts\python.exe 结尾,macOS 与 Linux 通常以 .venv/bin/python 结尾。只要两个命令都指向同一个 .venv,环境隔离就已生效。

处理常见失败

PowerShell 若提示禁止运行脚本,可只为当前窗口临时放宽策略,然后重新激活虚拟环境:

powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1

预期结果是当前 PowerShell 会话允许执行激活脚本,命令提示符前出现 (.venv);关闭窗口后该临时设置自动失效。

若 python3 -m venv .venv 报缺少 venv 模块,应先安装系统对应的 python3-venv 包。若版本检查仍指向系统 Python,先确认虚拟环境已激活,再使用 python -c "import sys; print(sys.executable)" 定位实际解释器。

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

目录与阅读设置

阅读设置

17

记录一个想法

安装 Python 环境

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

登录哪都通