最终架构前置【安装wsl】这个命令是安装 WSL 和 Ubuntu的官方命令我们把它拆开来看就很好理解。打开终端执行如下命令来安装wslwsl --install -d Ubuntu安装WSL到指定目录默认安装到C盘如果想安装到指定目录可以按下面方法进行。先安装后迁移第一步安装wslwsl --install -d Ubuntu第二步关闭wslwsl --shutdown第三步导出Ubuntu导出为tar压缩包还不能用wsl --export Ubuntu D:\WSL\ubuntu.tar将Ubuntu导入到D:\WSL\ubuntu.tar这里第四步注销原来的Ubuntu这一步会删除原来的 WSL但因为已经导出了所以不用担心。wsl --unregister Ubuntu第五步导入到指定目录eg安装到D:\WSL\Ubuntuwsl --import Ubuntu D:\WSL\Ubuntu D:\WSL\ubuntu.tar第六步启动wsl打开powershell输入wsl命令解析第一部分wsl就是Windows Subsystem for LinuxWindows 的 Linux 子系统。你以后所有关于 WSL 的命令几乎都是以wsl开头例如wsl wsl --list wsl --shutdown wsl --export wsl --import第二部分--install表示安装 WSL 和 Linux 发行版。例如wsl --install如果不指定发行版Windows 通常会安装默认的 Ubuntu。第三部分-d-d 是--distribution的缩写。意思是指定要安装哪个 Linux 发行版。例如wsl --install -d Ubuntu就是安装 Ubuntu。还可以安装其他发行版wsl --install -d Debian安装 Debian。wsl --install -d kali-linux安装 Kali Linux。执行命令后Windows 会自动① 开启 WSL 功能 ↓ ② 开启虚拟机平台 ↓ ③ 下载 Ubuntu ↓ ④ 安装 Ubuntu ↓ ⑤ 第一次启动 Ubuntu ↓ ⑥ 让你创建 Linux 用户名和密码完成后就可以使用wsl进入qyyDESKTOP:~$以后你最常用的几个wsl命令命令作用wsl进入默认 Ubuntuwsl -l -v查看安装了哪些发行版wsl --shutdown关闭所有 WSLwsl --status查看 WSL 状态wsl --install -d Ubuntu安装 Ubuntuwsl --export Ubuntu backup.tar导出 Ubuntuwsl --import Ubuntu D:\WSL backup.tar --version 2导入到指定目录wsl --unregister Ubuntu删除 Ubuntu会删除数据Q为什么推荐 Ubuntu答因为 Ubuntu 是目前最流行的 Linux 发行版之一文档丰富、社区活跃大多数 AI、Python、Docker、云服务器教程都默认使用 Ubuntu因此非常适合作为 AI Agent 开发环境。第一部分Windows 安装的软件这些安装在 Windows。① Windows Terminal推荐终端窗口。以后打开Ubuntu、PowerShell、CMD都可以。如果不喜欢也可以直接打开 Ubuntu。② VS Code ⭐⭐⭐⭐⭐你的主要 IDE。安装扩展Python WSL Pylance Docker以后 GitLens可选 Error Lens可选安装完WSL扩展以后打开ubuntu就可以通过下面命令打开 VS Codecode .后续可以用③ Docker Desktop安装在 Windows。但是以后 Docker 命令全部在 Ubuntu 里面运行。这需要打开Docker Desktop之后设置一下WSL集成设置完成后重启电脑再打开Docker Desktop即可再打开Ubuntu输入docker --version就可以看到当前Docker的版本了。但是如果还要执行docker ps这些命令需要连接Docker EngineDocker 的 Unix socket 默认需要 root 权限或docker用户组成员权限。在 Ubuntu 中执行sudo usermod -aG docker $USER然后让新用户组立即生效newgrp docker这样就可以在Ubuntu里面使用docker了④ Chrome开发调试。⑤ Cursor可选以后可以替代 VS Code。很多 AI 工程师都在用。第二部分UbuntuWSL安装的软件以后所有开发工具全部安装这里。所有工具一起安装sudo apt update sudo apt install -y \ git \ curl \ wget \ zip \ unzip \ tree \ htop \ build-essentialGit安装sudo apt updatesudo apt install git检查git --versionPythonUbuntu 基本已经自带。检查python3 --versionuv ⭐⭐⭐⭐⭐Python 包管理。是Astral 公司开发的一款极速 Python 包和项目管理器核心作用就是帮你更快、更方便地管理 Python 项目。相当于pip、venv、pyenv和pip-tools等工具的“超级合体”。安装curl -LsSf https://astral.sh/uv/install.sh | sh出现qyyhuanshu:~$ curl -LsSf https://astral.sh/uv/install.sh | sh downloading uv 0.11.29 x86_64-unknown-linux-gnu installing to /home/qyy/.local/bin uv uvx everythings installed! To add $HOME/.local/bin to your PATH, either restart your shell or run: source $HOME/.local/bin/env (sh, bash, zsh) source $HOME/.local/bin/env.fish (fish)安装完后还要配置环境变量根据提示运行下面命令source $HOME/.local/bin/env之后通过uv --version输出qyyhuanshu:~$ uv --version uv 0.11.29 (x86_64-unknown-linux-gnu)说明安装成功。curl安装这个可以通过命令行下载工具相当于终端里的浏览器。sudo apt install curlwget这个也是一个下载工具和curl差不多sudo apt install wgetunzip解压工具unzip project.zipsudo apt install unzipzip压缩工具sudo apt install zipbuild-essential以后很多 Python 包都会用。这是linux的C/C 编译环境有些库需要C语言编译。sudo apt install build-essentialtree推荐查看目录。sudo apt install tree例如tree输出Projects ├── ai-agent ├── fastapi └── langgraphhtop推荐查看进程。sudo apt install htop以后htop比top舒服很多。第三部分以后安装开始 AI 开发时Node.js推荐安装nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash使用 nvm 安装 Node.js①先安装nvm官方安装curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash刷新环境source ~/.bashrc验证command -v nvm应该输出nvm安装 Node.js安装最新版 LTSnvm install --lts设为默认nvm alias default lts/*查看node -vnpm -v例如不要apt install nodejs推荐使用nvmpnpmnpm install -g pnpmDocker CLI安装 Docker Desktop 后根据上面的配置就可以直接用。第四部分Python 库以后项目里面不要pip install推荐uv add fastapiuv add openaiuv add langgraphuv add pydanticuv add httpx因为uv是新一代的 Python 工具链不仅能安装依赖还能自动管理虚拟环境、项目依赖和版本锁定速度比pip快很多开发体验也更好。pip更适合维护老项目而对于新建的 AI Agent 项目通常推荐使用uv因为它已经逐渐成为现代 Python 开发的主流工具。第五部分以后每天开发流程每天Windows │ ▼ 打开 Ubuntu │ ▼ cd ~/Projects │ ▼ code . │ ▼ VS Code │ ▼ 开始开发几乎不会进入CMD第六部分Linux 命令必须会★★★★★pwd ls cd mkdir touch cp mv rm find grep cat less head tail★★★★☆chmod chown ps kill lsof top htop★★★☆☆zip unzip tar df du free第七部分Git必须git clone git status git add git commit git pull git push git branch git checkout至少要熟练这些。第八部分AI Agent 学习顺序这是我最推荐你的路线。Linux │ Git │ Python │ uv │ FastAPI │ OpenAI SDK │ Prompt Engineering │ Function Calling │ MCP │ LangGraph │ RAG │ Docker │ Redis │ PostgreSQL │ Agent项目第九部分以后需要学习的软件建议顺序VS Code Git Python uv Node.js pnpm Docker FastAPI OpenAI SDK LangGraph MCP Redis PostgreSQL Qdrant第十部分真正企业里的开发环境以后你的电脑应该像这样Windows │ ├── VS Code ├── Docker Desktop ├── Chrome ├── Cursor可选 │ └── UbuntuWSL │ ├── Git ├── Python ├── uv ├── Node.js ├── pnpm ├── FastAPI ├── Docker CLI ├── OpenAI SDK ├── LangGraph ├── MCP └── Projects所有代码