Windows 10下如何配置Ubuntu子系统与PyCharm开发Django项目及虚拟环境

一、初始化WSL Ubuntu #

• 打开Windows终端，输入ubuntu启动，按提示设置用户名和密码
• 更新系统包：

  sudo apt update && sudo apt upgrade -y
  

• 安装Python基础依赖：

  sudo apt install python3 python3-pip python3-venv -y
  

二、在Ubuntu中搭建Django项目的虚拟环境 #

• 创建项目存储目录（示例放在用户主目录）：

  mkdir ~/django_projects && cd ~/django_projects
  

• 创建虚拟环境：

  python3 -m venv venv
  

• 激活虚拟环境：

  source venv/bin/activate
  

• 安装Django、Celery及相关依赖（以Redis作为消息队列为例）：

  pip install django celery redis
  

三、配置PyCharm连接WSL环境 #

1. 打开PyCharm，按下Ctrl+Alt+S打开设置界面
2. 进入Project: [你的项目名] > Python Interpreter，点击右上角齿轮图标选择Add
3. 在弹出窗口中切换到WSL选项卡，选择你安装的Ubuntu发行版
4. 定位到之前创建的虚拟环境Python路径：~/django_projects/venv/bin/python3，点击OK完成解释器配置
5. （可选）配置路径映射：进入Settings > Build, Execution, Deployment > Deployment，添加WSL连接，设置本地项目目录与Ubuntu目录的对应关系（比如本地D:\django_projects对应Ubuntu~/django_projects）

四、迁移现有Django项目到WSL #

• 通过Windows文件管理器访问\\wsl$\Ubuntu\home\你的用户名\django_projects，将本地项目文件复制到该目录
• 在PyCharm中打开WSL里的项目目录，激活虚拟环境后安装项目依赖：

  pip install -r requirements.txt
  

• 执行数据库迁移：

  python manage.py migrate
  

五、测试Celery与Django运行 #

• 安装并启动Redis服务（如果用Redis做消息队列）：

  sudo apt install redis-server -y
  sudo systemctl start redis-server
  

• 在PyCharm的终端（已自动连接WSL并激活虚拟环境）中启动Celery worker：

  celery -A 你的项目名 worker -l info
  

• 启动Django开发服务器（用0.0.0.0允许Windows端访问）：

  python manage.py runserver 0.0.0.0:8000
  

  之后在Windows浏览器访问localhost:8000即可正常使用Django服务。

内容的提问来源于stack exchange，提问作者Anna Berezko