Win11+WSL2搭建LangGraph开发环境全攻略

环境准备

确保系统已安装以下组件：

• Windows 11 21H2及以上版本
• WSL2（Ubuntu 22.04发行版）
• PyCharm Professional（支持WSL2集成）
• Python 3.9+

在Ubuntu子系统中运行以下命令更新基础环境：

sudo apt update && sudo apt upgrade -y
sudo apt install -y python3-pip python3-venv git curl

WSL2配置

启用WSL2的GPU加速支持（需NVIDIA显卡）：

curl -s https://raw.githubusercontent.com/microsoft/wslg/main/scripts/install-nvidia-vulkan.sh | bash

配置内存限制（防止OOM），在%UserProfile%\.wslconfig中添加：

[wsl2]
memory=8GB
swap=4GB

项目环境搭建

创建隔离的Python环境并安装依赖：

mkdir ~/langgraph_project && cd ~/langgraph_project
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip wheel

安装核心依赖包：

pip install langgraph google-generativeai fastapi uvicorn python-dotenv

PyCharm集成配置

1. 在PyCharm中创建新项目时选择"WSL"解释器路径：

   \\wsl$\Ubuntu-22.04\home\<user>\langgraph_project\.venv\bin\python
   

2. 配置项目目录映射：

   • 添加WSL文件系统路径：\\wsl$\Ubuntu-22.04\home\<user>\langgraph_project
   • 设置本地工作目录为Windows对应路径

3. 启用终端集成：

   • 在Settings > Tools > Terminal修改Shell path为：

   w