实战SOP:让CodeArts替我装WSL2

背景:装WSL2这活儿,步骤不多但坑不少

Windows上跑Linux,WSL2是最轻量的方案。装起来官方说一条命令wsl --install就行,但实际操作时会遇到:BIOS虚拟化没开、系统版本不够、装完要重启、重启后还要继续配、网络不通下载卡住、设默认用户、配内存限制……每一步都不难,但加起来够折腾一阵。

这次把整个安装过程交给码道CodeArts,用自然语言说清楚需求和前置条件,让它一步步执行。从检查系统到安装到配置到验证,全程不用自己开PowerShell敲命令。本文记录完整过程,给想用AI Agent做系统环境搭建的人一个参考。

方案:五步从检查到可用WSL2

整体流程

第一步:用自然语言下指令

打开码道CLI,输入需求:

帮我在这台Windows 11上安装WSL2,要求:
1. 先检查系统版本和虚拟化是否满足要求
2. 用wsl --install安装,如果网络不通就用web-download方式
3. 装好后设WSL2为默认版本
4. 配置.wslconfig,内存限制4GB,处理器2核
5. 最后验证wsl --status和跑几条Linux命令确认可用

CodeArts收到后列了五步执行计划,每步标注要跑的命令和预期结果。

第二步:检查前置条件

# 检查Windows版本
winver
# 或用命令行查
powershell -Command "[System.Environment]::OSVersion.Version"

# 检查虚拟化是否启用
powershell -Command "Get-ComputerInfo -Property 'HyperV*'"

CodeArts检查了系统版本是Windows 11(满足要求),然后查虚拟化状态。如果虚拟化没开,它会提示需要进BIOS开启——这步没法用命令行解决,CodeArts明确告诉你去BIOS开VT-x,而不是瞎试命令。

第三步:安装WSL2

# 一键安装(启用WSL组件+装内核+设WSL2默认+装Ubuntu)
wsl --install

# 如果下载卡住,改用web-download
wsl --install --web-download

wsl --install这条命令做了四件事:启用"适用于Linux的Windows子系统"功能、启用"虚拟机平台"、下载安装Linux内核、安装Ubuntu发行版。装完需要重启。

这步有个关键点:重启后CodeArts的会话会断。CodeArts在重启前提示"重启后重新打开CLI,输入’继续安装WSL2’",它把当前进度存好,重启后能接着跑。手动装时容易重启完忘了该干嘛,CodeArts帮你记着。

第四步:配置WSL2

重启后继续,CodeArts配置资源限制:

# 确保WSL2是默认版本
wsl --set-default-version 2

# 写.wslconfig限制资源(放在用户目录下)
# 路径: C:\Users\<用户名>\.wslconfig

.wslconfig内容:

[wsl2]
memory=4GB
processors=2
swap=2GB
localhostForwarding=true

这步手动做容易把.wslconfig放错位置——必须在用户目录下(如C:\Users\你的用户名.wslconfig),放在别处WSL不读。CodeArts自动找到了当前用户目录并写入。

第五步:验证WSL2可用

# 查看WSL状态
wsl --status

# 列出已安装发行版及版本号
wsl -l -v

# 预期输出:
#   Ubuntu    Running    2
#   (版本列显示2表示WSL2模式)

然后在WSL里跑几条Linux命令:

# 进入WSL
wsl

# 验证Linux环境
uname -a          # 应显示Linux内核版本
cat /etc/os-release  # 应显示Ubuntu版本信息
df -h             # 查看磁盘空间
whoami            # 当前用户名
exit              # 退出WSL

CodeArts跑完这些命令,确认WSL2正常运行、Ubuntu可用、Linux命令能执行。它还额外检查了wsl -l -v输出里的版本号确实是2(不是1),因为有时装完默认还是WSL1,需要手动切换。

实践要点

1. BIOS虚拟化是硬前提:CPU虚拟化(VT-x或AMD-V)必须在BIOS里开启,没有任何命令行方式能绕过。CodeArts检查到没开时会明确告诉你"这步需要人工进BIOS操作",不会瞎试。先开虚拟化再装WSL2,顺序不能反。

2. 网络问题用web-download:国内网络环境下,wsl --install下载Ubuntu时可能卡在0%。加--web-download参数走网页下载通道,成功率更高。如果web-download也卡,可以手动从微软官方页面下载发行版包再导入,CodeArts可以帮你走import路径。

3. 重启后会话中断要处理:WSL2安装过程中必须重启一次,AI Agent的会话会断。两种处理方式:一是重启前让CodeArts存好进度,重启后手动说"继续";二是把安装脚本写成PS1文件,重启后自动执行剩余步骤。第一种更灵活,适合交互式安装。

4. .wslconfig位置不能错:这个文件必须在C:\Users\<用户名>\.wslconfig,不是WSL内部,不是项目目录。写错位置WSL不会报错但也不读配置,内存限制不生效。用echo %USERPROFILE%确认用户目录路径再写。

5. WSL2和WSL1的区别要确认:wsl -l -v输出里的VERSION列必须是2。如果是1,用wsl --set-version Ubuntu 2转换。WSL1用翻译层跑Linux,兼容性好但性能差;WSL2用轻量VM跑完整内核,性能接近原生但网络模型不同。装WSL2就是为了用WSL2,别装完发现还是1。

小结

用CodeArts装WSL2,省的不是命令(核心就一条wsl --install),省的是"装完重启后该干嘛"、“下载卡住怎么换方式”、".wslconfig放哪里"这些零碎但卡人的细节。AI Agent把这些细节串成一条线,你只需要在关键节点(重启、BIOS)人工介入,其余全自动。

从效率看,手动装WSL2约20分钟(含重启和排错),用CodeArts约8分钟(含一次重启)。差距主要在"不用查文档确认每步该跑什么命令"和"不用排查下载卡住的原因"这两点上。对于不常做系统配置的人,有AI Agent兜底心里踏实——不怕漏步骤,不怕放错配置文件。