Day 1任务Windows 开发环境搭建目标把 Python、Git、Docker、PHP、Composer 全部装好并验证通过。预计耗时1.5–2 小时含下载等待。验收标准5 条命令全部输出版本号Docker Desktop 显示 WSL2 引擎运行中。0. 开始前的检查10 分钟0.1 系统版本确认按Win R输入winver回车。要求Windows 10 版本 ≥ 2004内部版本 19041或 Windows 11 任意版本如果低于 2004先 Windows Update 升级。WSL2 需要这个版本。0.2 磁盘空间确认打开「此电脑」确认D 盘剩余 ≥ 40GB。用途预估项目占用Python venv PyTorch CUDA约 8GBDocker Desktop Hyperf 镜像约 6GBQwen2.5-Coder-0.5B 模型约 1GB数据、输出、日志约 5GB余量20GB如果 D 盘不够用 C 盘但后续所有路径改成C:\hyperf-coder。0.3 虚拟化确认按Ctrl Shift Esc打开任务管理器 → 性能 → CPU。右下角应显示虚拟化已启用。如果显示「已禁用」重启电脑进 BIOS一般 F2 / Del / F10找到Intel VT-x或Virtualization Technology设为 Enabled保存重启没有虚拟化Docker Desktop 无法运行。0.4 关闭冲突软件暂时关闭或卸载旧版 Docker ToolboxVirtualBox与 Hyper-V 冲突Docker Desktop 用 WSL2 时也可能冲突360 安全卫士 / 腾讯电脑管家会拦 winget 安装代理软件先记下端口后面可能要配0.5 确认 winget 可用打开PowerShell管理员开始菜单 → 输入PowerShell→ 右键 → 以管理员身份运行。winget--version期望输出v1.6.x或更高。如果没有 winget打开 Microsoft Store搜索「应用安装程序」安装/更新重开 PowerShell 再试1. 安装 Git10 分钟winget install--id Git.Git-e--source winget参数说明--id Git.Git精确指定包 ID-e精确匹配避免装错--source winget从 winget 源装安装过程会弹 UAC点「是」。装完后关闭当前 PowerShell重新以管理员打开让 PATH 生效。验证git--version期望git version 2.4x.x.windows.1配置身份后面 commit 要用git config--global user.name你的名字git config--global user.email你的邮箱example.comgit config--global init.defaultBranch main git config--global core.autocrlf true验证git config--global--list2. 安装 Python 3.1110 分钟winget install--id Python.Python.3.11-e--source winget不要装 3.12/3.13部分库尤其 trl、peft 旧版本兼容性不如 3.11。装完关闭 PowerShell重新以管理员打开。验证python--version pip--version期望Python 3.11.x pip 24.x from ... (python 3.11)如果python命令找不到打开「设置 → 应用 → 高级应用设置 → 应用执行别名」关闭python.exe和python3.exe的别名重开 PowerShell升级 pippython-m pip install--upgrade pip setuptools wheel3. 安装 PHP 8.310 分钟winget install--id PHP.PHP.8.3-e--source winget装完重开 PowerShell。验证php--version期望PHP 8.3.x (cli)如果没找到手动加 PATH找到C:\php或C:\Program Files\PHP\v8.3系统属性 → 环境变量 → Path → 新增该目录重开 PowerShell配置 php.ini可选为了php -l和 composer 正常# 找到 php.ini 位置php--ini如果显示没有 php.ini复制一份模板# 假设 PHP 在 C:\phpcopyC:\php\php.ini-development C:\php\php.ini编辑C:\php\php.ini取消注释extensioncurl extensionmbstring extensionopenssl extensionfileinfo保存后验证php-m应看到 curl、mbstring、openssl、fileinfo。4. 安装 Composer10 分钟Composer 不在 winget 里手动装# 下载安装器php-rcopy(https://getcomposer.org/installer, composer-setup.php);# 校验可选但推荐php-rif (hash_file(sha384, composer-setup.php) dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b) { echo Verifier OK . PHP_EOL; } else { echo Verifier FAIL . PHP_EOL; }# 安装到当前目录php composer-setup.php# 删除安装器php-runlink(composer-setup.php);# 移到全局mkdir C:\bin-Forcemovecomposer.phar C:\bin\composer.phar创建C:\bin\composer.batSet-Content-Path C:\bin\composer.bat-Valuephp %~dp0composer.phar %*加 PATH[Environment]::SetEnvironmentVariable(Path,[Environment]::GetEnvironmentVariable(Path,User);C:\bin,User)关闭并重新打开 PowerShell必须PATH 才生效。验证composer--version期望Composer version 2.7.x5. 安装 Docker Desktop30–60 分钟含下载winget install--id Docker.DockerDesktop-e--source winget下载约 500MB安装 5–10 分钟。安装时勾选✅ Use WSL 2 instead of Hyper-V✅ Add shortcut to desktop装完不要立即启动先装 WSL2。5.1 安装 WSL2wsl--install这会自动启用「适用于 Linux 的 Windows 子系统」启用「虚拟机平台」下载 WSL2 内核安装 Ubuntu 默认发行版装完必须重启电脑。重启后Ubuntu 会自动打开要求设置Enter new UNIX username: yourname New password: 输入时不显示正常 Retype new password:记住这个用户名密码后面 Docker 要用。验证 WSL2wsl--list--verbose期望NAME STATE VERSION * Ubuntu Running 2VERSION必须是2。如果是 1wsl--set-versionUbuntu 2 wsl--set-default-version 25.2 启动 Docker Desktop双击桌面图标启动。首次启动会接受服务协议跳过登录点 Skip跳过问卷等待引擎启动左下角鲸鱼图标变绿打开 Docker Desktop → 右上角齿轮 SettingsGeneral勾选Use the WSL 2 based engineResources → WSL Integration勾选Enable integration with my default WSL distro和UbuntuApply Restart验证docker--version docker compose version docker run hello-world期望Docker version 27.x.x Docker Compose version v2.x.x Hello from Docker!如果docker run hello-world卡住检查Docker Desktop 左下角是否绿色WSL2 是否在运行wsl --list --verbose是否需要开代理见第 7 节6. 安装 VS Code10 分钟winget install--id Microsoft.VisualStudioCode-e--source winget装完打开 VS Code装扩展CtrlShiftX 搜索安装扩展用途PythonPython 支持Pylance类型提示JupyterNotebookDocker容器管理Remote - WSLWSL 开发PHP IntelephensePHP 智能提示Chinese (Simplified)中文界面可选7. 网络问题处理重要国内网络下winget / pip / docker 可能很慢或失败。7.1 pip 换源pip configsetglobal.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip configsetglobal.trusted-host pypi.tuna.tsinghua.edu.cn验证pip config list7.2 Docker 换镜像源Docker Desktop → Settings → Docker Engine修改 JSON{registry-mirrors:[https://docker.m.daocloud.io,https://dockerproxy.com,https://mirror.baidubce.com]}Apply Restart。验证docker pull hello-world7.3 HuggingFace 换源D3 之后用[Environment]::SetEnvironmentVariable(HF_ENDPOINT,https://hf-mirror.com,User)重开 PowerShell 生效。8. 建立项目目录10 分钟cd D:\ mkdir hyperf-coder cd hyperf-coder mkdirdatamkdirdata\raw mkdirdata\processed mkdir scripts mkdir outputs mkdir logs mkdir reports mkdir hyperf_sandbox mkdir colab# 初始化 gitgit init创建.gitignore venv/ __pycache__/ *.pyc outputs/ logs/ data/raw/ data/processed/ hyperf_sandbox/workspace/ chroma_db/ *.gguf *.safetensors .env |Out-File-Encoding utf8.gitignore创建README.md # Hyperf Coder 基于 Qwen2.5-Coder-0.5B 微调的 Hyperf 代码助手。 ## 环境 - Windows 10/11 - Python 3.11 - PyTorch CUDA 12.1 - GTX 1660 Ti 6GB - Docker Desktop WSL2 ## 目录 - data/ 数据 - scripts/ 脚本 - outputs/ 模型输出 - hyperf_sandbox/ Hyperf 沙箱 - reports/ 评估报告 |Out-File-Encoding utf8 README.md首次 commitgit add.git commit-mchore: init project structure9. Day 1 验收清单逐条打勾[ ] winver 显示 Windows 10 2004 或 Windows 11 [ ] 任务管理器显示虚拟化已启用 [ ] D 盘剩余 ≥ 40GB [ ] git --version 输出版本号 [ ] python --version 输出 3.11.x [ ] pip --version 输出 24.x [ ] php --version 输出 8.3.x [ ] php -m 包含 curl/mbstring/openssl/fileinfo [ ] composer --version 输出 2.7.x [ ] docker --version 输出 27.x [ ] docker compose version 输出 v2.x [ ] docker run hello-world 成功 [ ] wsl --list --verbose 显示 VERSION 2 [ ] VS Code 已装并装好扩展 [ ] D:\hyperf-coder 目录结构创建完成 [ ] git commit 成功全部打勾Day 1 完成。10. 一条命令总验证把下面整段粘到 PowerShell 跑Write-Host Day 1 环境验收 -ForegroundColor CyanWrite-Hostn[1] Git-ForegroundColor Yellow git--versionWrite-Hostn[2] Python-ForegroundColor Yellow python--version pip--versionWrite-Hostn[3] PHP-ForegroundColor Yellow php--version|Select-Object-First 1 php-m|Select-Stringcurl|mbstring|openssl|fileinfoWrite-Hostn[4] Composer-ForegroundColor Yellow composer--versionWrite-Hostn[5] Docker-ForegroundColor Yellow docker--version docker compose versionWrite-Hostn[6] WSL-ForegroundColor Yellow wsl--list--verboseWrite-Hostn[7] 项目目录-ForegroundColor YellowGet-ChildItemD:\hyperf-coder|Select-ObjectNameWrite-Hostn 验收结束 -ForegroundColor Cyan期望看到每项都有版本号没有红色报错。11. 常见故障排查问题 1winget 报「找不到源」winget source update winget source list如果源损坏winget source reset--force问题 2Python 命令打开 Microsoft Store「设置 → 应用 → 高级应用设置 → 应用执行别名」关闭python.exe和python3.exe。问题 3Docker Desktop 启动卡在 “Starting…”先确认 WSL2 正常wsl--shutdown wsl--list--verbose再重启 Docker Desktop。还不行# 重置 Docker 网络docker network prune-f问题 4wsl --install报 0x800701bc说明 WSL2 内核没装下载 https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi安装重跑wsl --install问题 5Composer 校验失败跳过校验直接装php-rcopy(https://getcomposer.org/installer, composer-setup.php);php composer-setup.php--no-check php-runlink(composer-setup.php);问题 6公司网络/代理如果公司网络有代理winget 和 docker 需要配# winget 代理winget settingssetnetwork.proxy http://proxy.company.com:8080# Docker Desktop → Settings → Resources → Proxies 填代理12. Day 1 结束时的状态你应该有D:\hyperf-coder\ ├── .git\ ├── .gitignore ├── README.md ├── data\ │ ├── raw\ │ └── processed\ ├── scripts\ ├── outputs\ ├── logs\ ├── reports\ ├── hyperf_sandbox\ └── colab\外部工具Git 2.4xPython 3.11PHP 8.3Composer 2.7Docker Desktop WSL2 UbuntuVS Code 扩展13. Day 1 结束语Day 1 只做环境不碰模型、不碰数据、不碰训练。环境稳后面 11 周才稳。遇到报错不要跳过逐条解决。Day 2 预告建 Python venv装 CUDA 版 PyTorch验证torch.cuda.is_available()返回 True验证GTX 1660 Ti被识别
