安装 Python 与隔离开发环境
学习目标
创建独立虚拟环境,用指定解释器安装 Django 6.1.2,知道命令运行在哪个目录,以及如何重新进入工作环境。
为什么使用虚拟环境和固定版本
系统 Python、本站 Docker 和你的练习项目是三个不同环境。pip install 装到错误解释器里,会出现“刚安装却无法 import”的困惑。虚拟环境让依赖只属于一个项目;固定版本让教材示例、测试结果和同学之间的环境能够对应。
先到 Python 官方网站安装 Python 3.14 系列的维护版本。Windows 安装后使用 py -3.14;macOS/Linux 通常使用 python3.14。Linux 不要替换系统自带的 /usr/bin/python3,可以使用独立安装路径。下列命令不要求管理员权限,项目目录不要放在系统保护目录中。
具体怎么做
macOS/Linux:
mkdir zhixing-blog
cd zhixing-blog
python3.14 -m venv .venv
source .venv/bin/activate
python -m pip install Django==6.1.2
python -m django --version
python -c "import sys; print(sys.executable); print(sys.version)"
Windows PowerShell:
mkdir zhixing-blog
cd zhixing-blog
py -3.14 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install Django==6.1.2
python -m django --version
python -c "import sys; print(sys.executable); print(sys.version)"
如果 PowerShell 不允许激活脚本,不必修改全局策略,直接使用虚拟环境解释器,例如 .\.venv\Scripts\python.exe -m pip install Django==6.1.2,后面把 python 替换为这个路径即可。
在项目根目录保存 requirements.txt 和 .gitignore。后续章节新增依赖后,重新执行 python -m pip install -r requirements.txt。数据库、媒体和 .env 不提交到 Git;迁移文件是项目源代码,应当提交。
本章新增或替换的完整文件
以下路径均相对于练习项目根目录。替换同名文件的全部内容;未列出的文件保持上一章版本。
.gitignore
.venv/
__pycache__/
*.pyc
*.sqlite3
.env
media/
staticfiles/
backups/
requirements.txt
Django==6.1.2
如何确认成功
python -m django --version 输出 6.1.2;sys.executable 指向 zhixing-blog/.venv/ 下的解释器。再执行:
python -m pip check
python -c "import django, sqlite3; print(django.get_version()); print(sqlite3.sqlite_version)"
预期没有依赖冲突。关闭终端后重新打开,先进入 zhixing-blog 并再次激活环境,再运行上述检查。
练习:创建一个文本学习日志,记录操作系统、Python、Django 版本和练习目录。将依赖文件交给另一台机器时,说明为什么不需要复制 .venv。
常见问题
找不到 python3.14? 安装对应解释器并重开终端,Windows 使用 py -0p 查看安装位置。下载超时? 检查网络和包索引来源,使用受信任的 HTTPS 源;不要为了下载关闭证书验证。可以用 Python 3.15 吗? 本教程锁定 6.1.2,选兼容范围内的 3.14;不要根据未来补丁版文档推断兼容性。
官方参考
登录后可保存阅读位置、标记章节完成,并在其他设备继续学习。
登录并保存学习进度 →联系站长
微信:VIPdjango。技术问题建议先在 社区讨论 中交流,方便更多人参与和查阅。
章节讨论 0