在Windows上搭建Fitten Code跨平台开发环境
若你希望在Windows系统中借助Fitten Code进行跨平台开发，稳定的WSL环境是确保Python生态与GPU加速能力正常运行的基础。一旦基础环节出现问题，后续所有模型加载、代码调试都将陷入依赖报错或CUDA不可用的困境。换言之，地基不牢，上层建设便无从谈起。
以下是准备工作清单：启用WSL2并安装Ubuntu 22.04，配置Python 3.11与CUDA GPU加速，搭建虚拟环境，最后克隆Fitten Code仓库并启动。每个步骤都可能遇到问题，但只要严格按照以下流程操作，基本能一次性顺利通过。
启用WSL2并安装Ubuntu发行版
以管理员身份打开PowerShell，依次执行下面两条命令：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart → dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重启电脑后，在PowerShell中直接运行：【wsl --install】。该命令会自动下载并安装WSL2内核、Ubuntu 22.04 LTS发行版，并将其设为默认版本。如果之前安装过旧版WSL1，此操作会强制升级至WSL2——【这是GPU加速与Docker支持的前提条件，跳过将导致Fitten Code无法调用本地显卡】。
首次启动Ubuntu时，根据提示创建Linux用户名与密码。请注意不要使用root账户或空密码，否则后续执行pip install时会出现权限错误。
配置基础开发环境
进入WSL终端后，首先更新系统包索引和核心工具：
sudo apt update && sudo apt upgrade -y
安装Python 3.11及pipenv（用于隔离Fitten Code项目依赖）：
sudo apt install -y python3.11 python3.11-venv python3-pip curl git
将pip指向Python 3.11版本：
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1 && sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 2 && sudo update-alternatives --config python3
选择编号2以确认使用3.11版。此步骤不可省略——Fitten Code官方要求Python版本≥3.10.12且＜3.12，而Ubuntu 22.04源中的3.10存在兼容性问题。
启用GPU加速支持（NVIDIA用户必做）
提供两种可选方案，请根据实际使用场景选择其一：
方法一：安装NVIDIA Container Toolkit（适用于WSL2+Docker环境）
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -fsSL https://nvidia.github.io/libnvidia-container/stable/deb/inverse-path/nvidia-container-toolkit.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
方法二：直接安装CUDA Toolkit for WSL（轻量级方案，无需Docker）
访问 https://developer.nvidia.com/cuda-toolkit-wsl 下载对应版本的.run文件（如cuda_12.4.0_535.104.05_linux_sbsa.run），然后执行：
sudo sh cuda_*.run --silent --override
验证是否生效：运行nvidia-smi。若显示GPU型号与驱动版本，说明CUDA已准备就绪；若报“NVIDIA-SMI has failed”，请检查Windows端的NVIDIA驱动是否已升级至535.x或更高版本。
安装并启动Fitten Code
第一步：克隆官方仓库
git clone https://github.com/fitten-ai/fitten-code.git && cd fitten-code
第二步：创建虚拟环境并安装依赖
python3 -m venv .venv && source .venv/bin/activate && pip install --upgrade pip && pip install -e ".[dev]"
第三步：启动服务
fitten-code serve --host 0.0.0.0 --port 8000
启动成功后，在Windows浏览器中访问 http://localhost:8000，即可进入Fitten Code Web UI界面。此时所有代码补全、单元测试生成、模型推理均通过WSL内的Python环境运行，且GPU算力直通无损耗——这才是真正意义上的跨平台开发体验。