Python 3.15.1 怎么给课程项目建虚拟环境?2026 新手教程

Python 3.15.1 怎么给课程项目建虚拟环境?2026 新手教程

症状:课程作业提示找不到库,或者你不确定终端正在用哪个 Python。 最快解法:先按课程指定版本创建项目专属虚拟环境,再把依赖装进这个环境并运行作业;课程若指定其他版本,就不要为了追新版本改用 Python 3.15.1。

谁该看这篇:刚开始学 Python、要完成第一份课程作业的学生;有多个项目、遇到依赖互相影响的自学者。
也适合:平时用 Windows 写代码,之后需要在 Mac 或远程 Mac 上接续同一个项目的学习者。

最后更新于 2026 年 10 月 24 日;已核对 Python 3.15.1 官方发布页及 Python 3.15 的虚拟环境文档。

选 Python 3.15.1,还是课程指定的版本?

先看课程说明、作业文件和教学平台的要求,再决定创建环境时调用哪个解释器。虚拟环境会使用你创建它时调用的 Python;它能隔离项目依赖,却不能把一个版本“变成”另一个版本。Python 官方发布页确认 Python 3.15.1 于 2026 年 10 月 21 日发布,但这不代表每门课程都要求使用它。[官方发布页](https://www.python.org/downloads/release/python-3151/)也说明了该版本及发布日期。

选择 评分(课程匹配度) 适用情况
课程明确指定的 Python 版本 优先 作业、自动评分或课堂材料写明版本时
Python 3.15.1 有条件 课程允许使用,且你确认当前终端可以调用这个版本时
电脑上默认的 Python 需核对 只有确认它符合课程要求后再用;不要仅凭“能启动”判断

先在终端检查当前解释器。Windows 可用 py -V:3.15 --version 查看对应版本;macOS 或 Linux 可用 python3.15 --version。若课程要求其他版本,就把命令里的版本选择替换成课程要求的解释器。Windows 的版本选择方式可参照 Python 官方 Windows 使用说明。

进入项目目录,再建一张独立的“实验桌”

虚拟环境可以理解成每门课的一张独立实验桌:这门课要用的 Python 包放在自己的桌面上,不会默认混进另一门课的环境。Python 的 venv 文档说明,环境默认与基础安装及其他虚拟环境隔离;环境通常放在项目目录中,常见目录名是 .venv。[Python 官方入门教程](https://docs.python.org/3.15/tutorial/venv.html)也展示了创建环境的方式。

先打开终端,进入含有作业文件的项目文件夹,再执行对应命令:

# macOS / Linux:使用已核对过的 Python 3.15
python3.15 -m venv .venv
# Windows:使用已核对过的 Python 3.15
py -V:3.15 -m venv .venv

如果课程指定其他版本,要先确认该版本已安装,再用它来运行 -m venv。例如,macOS 上如果课程指定的解释器命令是 python3.12,就用 python3.12 -m venv .venv。环境建在错误目录时,后续激活和运行作业容易找错路径;执行前看一眼终端当前位置,确认它就是项目文件夹。

平台与终端 创建环境 激活环境
macOS / Linux,bash 或 zsh python3.15 -m venv .venv source .venv/bin/activate
Windows,PowerShell py -V:3.15 -m venv .venv .venv\Scripts\Activate.ps1
Windows,命令提示符 py -V:3.15 -m venv .venv .venv\Scripts\activate.bat

创建命令与激活脚本按操作系统、终端类型区分;完整命令可对照 Python 官方 venv 激活说明。不要把 PowerShell 命令粘贴到 macOS 终端,也不要把 macOS 的 source 命令直接当成 Windows 命令使用。

激活后,怎么确认终端用的是环境里的 Python?

激活后,终端提示符通常会显示环境名;不过,提示符只是线索,检查解释器路径更可靠。在已激活的终端执行:

python --version
python -c "import sys; print(sys.executable); print(sys.prefix != sys.base_prefix)"

第一行显示当前 python 的版本。第二行会打印解释器路径,并检查当前解释器是否运行在虚拟环境中;结果为 True 才说明检查通过。Python 文档说明,虚拟环境中的 sys.prefix 与基础安装的 sys.base_prefix 不同;细节可查阅 sys 模块官方说明。

如果环境没有激活,先确认你仍在项目目录,再按当前操作系统和终端重新执行激活命令。若路径仍指向基础 Python,检查是否开了新的终端窗口——新窗口不会自动沿用之前终端的激活状态。你也可以直接调用环境里的解释器,但路径要对应当前平台:

# macOS / Linux
.venv/bin/python --version
# Windows
.venv\Scripts\python.exe --version

⚠️ 如果 PowerShell 拒绝运行激活脚本,先确认你执行的是 PowerShell 对应的 Activate.ps1,不是命令提示符的 .bat 文件;再查看 Python 官方文档中的激活说明。不要为了绕过提示而随意修改系统安全设置。

环境建好后,再安装课程依赖

虚拟环境不会自动带上课程需要的第三方库。安装前先检查作业说明、教师提供的依赖文件,或代码开头的 import 语句。若项目里已有 requirements.txt,在激活环境的终端执行:

python -m pip install -r requirements.txt

如果课程只要求安装某个包,就按课程给出的名称和版本安装,例如:

python -m pip install 包名

这里的“包名”是占位文字,不要原样输入;以课程资料中的名称替换。使用 python -m pip,可以让安装命令跟当前调用的 Python 关联,减少误装到全局环境或其他环境的可能。具体安装用法见 pip 官方安装命令说明;依赖文件的用途可查看 pip 官方用户指南与 requirements 文件格式说明。

依赖文件不在项目里时,不要凭感觉安装一串网上推荐的库。先问课程是否提供依赖清单;如果作业要求你记录安装内容,再依课程要求维护文件。pip freeze 可以输出当前环境中的已安装包,但是否把输出保存为项目依赖清单,应看老师或项目的交接规范。

运行作业前,用这份清单验收

下面逐项检查;出现问题时先停在对应步骤修复,再继续运行:

  • [ ] 终端当前目录是作业项目文件夹。
  • [ ] python --version 显示的版本符合课程要求。
  • [ ] 解释器路径指向项目的 .venv;sys.prefix != sys.base_prefix 检查结果为 True。
  • [ ] 已按课程说明安装依赖;如果有 requirements.txt,已在激活环境后安装它。
  • [ ] 使用课程要求的入口或最小作业文件运行程序,并检查预期输出。
  • [ ] 如果提交要求包含依赖记录,已按课程要求保存;没有要求时,不擅自改变提交结构。

程序提示“找不到模块”时,按顺序检查:当前终端有没有激活环境、python 路径是不是 .venv、对应依赖是否装进这个环境。再次运行作业验证,不要只凭安装命令没有报错就认定项目已通过。

换到 Mac 或远程 Mac,重新创建环境再接续

如果你先在 Windows 上写代码,之后要在 Mac 或远程 Mac 上运行,带上项目代码和课程要求的依赖记录;到目标机器后,在项目目录重新创建虚拟环境、安装依赖并验收。Python 官方文档明确提醒,虚拟环境通常不可移动或直接复制到另一位置;在目标位置重建更稳妥。你可以参照 Python 官方虚拟环境说明。

因此,不要把 .venv 文件夹当成项目交接的核心内容。交接时按课程要求保留代码和依赖清单;换了操作系统或解释器位置后,在新机器上重建环境。Windows 上的激活脚本也不能拿到 macOS 终端执行,反过来也一样。

若 Python 课程只要求常规脚本练习,你不必为了学习而租 Mac;现有电脑能够安装课程指定的 Python 时,继续本地开发就好。只有课程确实要求 Mac 操作,或你要把项目交到 macOS 环境验证、又无法使用自己的 Mac 时,才值得评估远程 Mac。你可以先了解 MacDate 的远程 Mac 学习环境,再结合自购设备的预算与使用周期,查看 Mac mini 价格指南作比较。远程环境不是 Python 入门的必需条件,而是本地设备无法完成指定 Mac 操作时的一种补充。

延伸阅读