Python虚拟环境搭建（Windows专用）
virtualenvwrapper-win + Django 启动完整教程

作用：隔离项目依赖、避免包冲突，适配 Django/Flask 等 Web 开发。

一、安装依赖工具

打开 CMD 执行：

pip install virtualenv virtualenvwrapper-win

说明：必须先装 virtualenv，再装 virtualenvwrapper‑win，否则会报找不到 virtualenv 错误。

二、配置环境变量（必须）

目的：统一管理所有虚拟环境目录

1. 右键此电脑 → 属性 → 高级系统设置 → 环境变量
2. 在系统变量新建：
   • 变量名：WORKON_HOME
   • 变量值：如 D:\PythonEnvs（自定义空文件夹）

必须关闭所有 CMD 重新打开，配置才生效。

不配置则默认路径：C:\Users\你的用户名\Envs

新增：最简单方法（不用手动找Python路径）

1. 查看电脑所有Python真实路径

在 CMD 里分别输入：

where python
where python3
where py

示例输出：

C:\Python311\python.exe
C:\Python39\python.exe
C:\Users\xxx\AppData\Local\Programs\Python\Python310\python.exe

2. 直接复制路径创建虚拟环境（指定版本）

mkvirtualenv --python=这里粘贴路径 虚拟环境名

例子：

mkvirtualenv --python=C:\Python39\python.exe mypy39

3. 懒人终极方法：无需记路径（Windows专属）

使用 py 命令自动选择版本（Windows 默认自带 Python 启动器）

mkvirtualenv --python="py -3.9" myenv39
mkvirtualenv --python="py -3.10" myenv310

这个方法不用写长路径，一键创建指定版本虚拟环境！

三、核心命令（完整版）

mkvirtualenv my_env

自动创建并自动进入，提示符前出现 (my_env) 表示成功。

mkvirtualenv --python=D:\Python39\python.exe my_env_py39

workon my_env

deactivate

rmvirtualenv my_env

lsvirtualenv
# 或直接输入 workon 回车
workon

cdvirtualenv

lssitepackages

1. 创建虚拟环境
2. 指定 Python 版本创建（多版本必备）
3. 进入 / 切换虚拟环境
4. 退出虚拟环境
5. 删除虚拟环境
6. 列出所有虚拟环境
7. 进入虚拟环境所在目录
8. 查看当前环境已安装包

四、虚拟环境内安装 Django + 启动项目

激活虚拟环境

workon my_env

安装 Django（仅当前环境生效）

pip install django
# 国内镜像加速
pip install django -i https://pypi.tuna.tsinghua.edu.cn/simple

查看 Django 版本

django-admin --version

进入项目存放目录

cd D:\my_projects

创建 Django 项目（末尾 . 必须加）

django-admin startproject mysite .

加 . 避免多层嵌套目录，新手必踩坑。

启动 Django 服务

python manage.py runserver
# 若 python 无效用
py manage.py runserver
# 指定端口
python manage.py runserver 127.0.0.1:8001

初始化数据库（必做）

python manage.py migrate

五、极简速查（复制即用）

# 安装工具 pip install virtualenv virtualenvwrapper-win # 环境变量 WORKON_HOME = D:\PythonEnvs # 虚拟环境常用命令 mkvirtualenv 名称 # 创建 workon 名称 # 进入 deactivate # 退出 rmvirtualenv 名称 # 删除 lsvirtualenv # 列表 # 多版本快速创建 mkvirtualenv --python="py -3.9" myenv39 # Django 一键流程 pip install django django-admin startproject mysite . python manage.py migrate python manage.py runserver

六、常见问题与解决

python manage.py runserver 8001

• mkvirtualenv 不是内部命令：未装 virtualenv；或未配置环境变量；或未重启 CMD。
• 指定 Python 版本失败：路径写错、无权限、Python 未添加到系统 PATH。
• python 命令无效：用 py 代替；或重装 Python 勾选 Add to PATH。
• 端口被占用：

七、补充：原生 virtualenv 用法（不装 wrapper）

pip install virtualenv # 创建 virtualenv my_env # 进入 cd my_env\Scripts activate # 退出 deactivate

八、最简洁总结

✅ virtualenvwrapper-win 指定版本 = 必须要路径

✅ 最快方法：用 where python 查路径，复制即用

✅ 懒人方法：用 py -3.x 代替路径，一键创建