计算机视觉 / 系统课时
安装 Python 环境
安装 Python 环境
本课完成 YOLOv8 项目的 Python 基础环境搭建。你将安装 Python 3.10 或以上版本,创建独立虚拟环境,并通过版本与路径检查确认项目不会误用系统中的其他解释器。
学习目标
- 在 Windows、macOS 或 Ubuntu 上安装可用的 Python 3
- 使用
venv为 YOLOv8 项目隔离依赖 - 验证
python、pip与虚拟环境路径是否一致
安装前先检查现有版本
先打开 PowerShell 或终端检查 Python 是否已经存在。不同系统的启动命令可能不同,只需执行与当前平台对应的一组。
python3 --version
python3 -m pip --version预期输出如下,具体补丁版本和安装路径可能不同:
Python 3.<MINOR>.<PATCH>
pip <VERSION> from <PATH> (python 3.<MINOR>)Windows 也可以使用 Python Launcher:
py --version
py -0p预期输出会列出已安装解释器,实际版本和路径可能不同:
Python 3.<MINOR>.<PATCH>
-V:3.<MINOR> * <PATH>\python.exe如果版本低于 3.10、命令不存在或路径指向不准备使用的解释器,再执行安装。
在当前系统安装 Python
Windows 建议使用 Python 官方安装程序。安装首页先勾选“Add python.exe to PATH”,再选择默认安装或自定义目录;安装完成后关闭并重新打开 PowerShell,让新的环境变量生效。
macOS 已安装 Homebrew 时,可以安装一个明确版本:
brew install python@3.11
python3.11 --version预期输出如下,补丁版本以实际安装结果为准:
Python 3.11.<PATCH>Ubuntu 可使用系统包管理器安装 Python、venv 和 pip:
sudo apt update
sudo apt install -y python3 python3-venv python3-pip
python3 --version预期结果是安装命令正常结束,并输出 3.10 或以上版本:
Python 3.<MINOR>.<PATCH>如果发行版仓库提供的版本低于项目要求,应改用新版发行版、pyenv 或经过维护的可信软件源,不要覆盖系统自带 Python。
创建项目虚拟环境
进入准备存放项目的目录,再创建名为 .venv 的虚拟环境。Windows PowerShell 使用以下命令:
mkdir yolov8-practice
cd yolov8-practice
py -3.10 -m venv .venv
.\.venv\Scripts\Activate.ps1
python --version预期结果是命令提示符前出现 (.venv),并显示所选解释器版本:
Python 3.10.<PATCH>如果本机安装的是其他 3.10 以上版本,把 -3.10 改为对应版本。macOS 或 Linux 使用以下命令:
mkdir -p yolov8-practice
cd yolov8-practice
python3 -m venv .venv
source .venv/bin/activate
python --version预期结果同样是终端前出现 (.venv),并输出虚拟环境中的 Python 版本:
Python 3.<MINOR>.<PATCH>虚拟环境目录只服务于当前项目,不应提交到 Git。后续安装的 YOLOv8、PyTorch 和其他依赖都会写入 .venv,避免污染系统环境或其他项目。
升级并验证 pip
激活虚拟环境后,用当前解释器调用 pip,这样可以避免 pip 与 python 指向不同安装位置。
python -m pip install --upgrade pip
python -m pip --version
python -c "import sys; print(sys.executable)"预期输出中的 Python 路径应位于当前项目的 .venv 目录,版本号和绝对路径会因系统而不同:
pip <VERSION> from <PATH>/.venv/<PATH> (python 3.<MINOR>)
<PATH>/.venv/<PATH>/pythonWindows 路径通常以 .venv\Scripts\python.exe 结尾,macOS 与 Linux 通常以 .venv/bin/python 结尾。只要两个命令都指向同一个 .venv,环境隔离就已生效。
处理常见失败
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)" 定位实际解释器。