WSL Containerswslc完整安装与使用复盘手册引用资料前置Windows WSL2 虚拟硬盘迁移终极方案Junction 一劳永逸告别 C 盘焦虑在WSL-podman-machine-default (Fedora Linux 42) 中安装 CUDA 13.0、cuDNN 9.14、Anaconda 2025.06、PyTorch 2.10在WSL2-Ubuntu中安装Anaconda、CUDA13.0、cuDNN9.12及PyTorch含完整环境验证【打造 AI 开发环境系列】WSL 路径治理必做篇先迁移再开发别让 C 盘爆满【理念●体系】从零打造 Windows WSL Docker Anaconda PyCharm 的 AI 全链路开发体系官方权威文档链接微软中文官方教程WSL 容器入门 https://learn.microsoft.com/zh-cn/windows/wsl/tutorials/wsl-containers微软英文 WSL 容器核心说明页 https://learn.microsoft.com/en-us/windows/wsl/wsl-containerGitHub WSL 2.9.3 Releasewslc 首发版本日志 https://newreleases.io/project/github/microsoft/WSL/release/2.9.3第三方实操参考https://pureinfotech.com/install-wsl-containers-windows-11/https://allthings.how/install-wsl-containers-on-windows-11-with-wslc-public-preview/一、概述什么是 wslcwslc.exe别名container.exe是微软内置在WSL 2.9.3 预发布版本的原生 Linux 容器 CLI 工具官方命名 WSL Containers2026 Build 大会发布公开预览版无需额外安装 Docker Desktop、Podman 等第三方客户端依托现有 WSL2 内核直接运行 OCI 标准容器镜像。核心特性客观复盘无营销原生集成 Windows仅更新 WSL 预发布内核即可启用无独立安装包CLI 语法高度兼容 Docker原有容器命令迁移成本极低复用系统硬件虚拟化、WSLg 图形、CUDA 显卡直通能力适配 AI、后端开发场景纯终端工具无常驻后台 GUI 托盘进程闲置资源占用更低隔离模型基于轻量 Hyper-V 虚拟机容器间资源边界隔离更强。适用 / 不适用场景✅ 适合本地轻量开发、临时数据库 / 中间件容器、AI 推理环境、不想安装重型容器客户端的用户 ❌ 不适合需要完整 Compose、K8s、可视化面板、企业集群管理的生产环境二、前置硬件 系统条件硬件CPU 开启 Intel VT-x / AMD-V 硬件虚拟化BIOS/UEFI 设置系统版本Windows 10 2004Build 19041、Windows 11 全版本Windows 预览版如本机 10.0.29617兼容性最佳基础组件已启用「适用于 Linux 的 Windows 子系统」「虚拟机平台」未安装 WSL 需先执行wsl --install权限所有更新、校验操作必须使用管理员终端PowerShell 5/7、Windows Terminal 均可。三、完整安装启用流程实操复盘重点补充终端刷新细节步骤 1更新 WSL 至预发布内核唯一开启 wslc 的途径稳定版 WSL 不含 wslc 二进制文件必须拉取预发布更新powershell# 管理员终端执行 wsl --update --pre-release执行日志示例本机实测plaintext正在检查更新。 正在更新适用于 Linux 的 Windows 子系统: 2.9.4。关键细节更新后旧终端无法识别新命令Windows 终端 / PowerShell 进程启动时一次性加载系统 PATH 与 System32 下可执行文件更新内核后wslc.exe才写入C:\Windows\System32已打开的旧终端不会自动刷新文件列表直接输入wslc会抛出「无法识别命令」报错这是绝大多数人踩坑的核心原因。步骤 2强制关闭全部 WSL 实例可选推荐powershellwsl --shutdown作用彻底释放正在运行的 WSL 内核进程保证新版本内核完整加载。步骤 3重新新开新终端推荐关闭所有已打开的 PowerShell/Windows Terminal 窗口右键开始菜单重新打开一个新终端若不在新终端中测试可能会出现在当前终端无法识别wslc命令的报错。步骤 4校验 WSL 整体内核版本确认版本≥2.9.3wslc 最低支持基线powershellwsl --version本机输出参考plaintextWSL 版本: 2.9.4.0 内核版本: 6.18.35.2-1 WSLg 版本: 1.0.79 MSRDC 版本: 1.2.7214 Direct3D 版本: 1.611.1-81528511 DXCore 版本: 10.0.26100.1-240331-1435.ge-release Windows 版本: 10.0.29617.1000步骤 5校验 wslc 是否正常加载新开管理员终端后执行powershell# 两种等价写法 wslc version wslc --version正常返回wslc 2.9.4.0四、高频报错完整排查重点标注终端刷新问题报错 1wslc : 不是可识别cmdlet/程序分层排查顺序按优先级第一层90% 场景未重启终端诱因更新wsl --update --pre-release后仍使用更新前打开的旧终端修复关闭所有终端重新以管理员身份新开窗口再执行wslc --version第二层仅执行 shutdown 但未重启终端wsl --shutdown仅关闭 Linux 内核不会刷新 Windows 终端的可执行文件缓存必须重启终端进程第三层内核更新未完整部署powershell# 验证二进制文件是否存在 Test-Path C:\Windows\System32\wslc.exe返回False则重新执行预发布更新powershellwsl --update --pre-release第四层重启电脑兜底新开终端仍失效时重启整机完成系统组件注册。报错 2输入wsl --get-version提示无效参数不存在该参数查看 WSL 组件版本固定为wsl --version查看本地 Linux 发行版列表使用wsl -l -v。五、wslc 基础核心命令兼容 Docker 标准语法1. 镜像管理imagepowershell# 拉取Docker Hub OCI镜像 wslc pull ubuntu wslc pull nginx # 列出本地镜像两条等价 wslc image ls wslc images # 删除指定镜像 wslc image rm ubuntu # 清理无标签、未使用的冗余镜像 wslc image prune2. 容器生命周期管理powershell# 临时测试容器退出自动销毁 wslc run --rm hello-world # 交互式进入Ubuntu容器终端 wslc run --rm -it ubuntu bash # 后台启动Nginx端口映射Windows 8080:80命名web wslc run -d --name web -p 8080:80 nginx # 查看运行中容器 wslc container ps wslc ps # 查看全部容器含已停止 wslc ps -a # 启停指定命名容器 wslc stop web wslc start web # 删除停止的容器 wslc rm web # 一键清理所有已停止容器 wslc container prune3. 辅助运维命令powershell# 实时查看容器CPU/内存资源占用 wslc stats # 打印容器运行日志 wslc logs web # 登录私有镜像仓库 wslc registry login [仓库地址] # 查看完整官方帮助文档 wslc --help # 单命令详细参数说明 wslc run --help六、wslc、Docker Desktop、Podman 客观对比表格对比维度wslc(WSL Containers)Docker DesktopPodman(WSL)安装方式WSL 预发布内核更新无独立程序完整客户端安装包单独下载安装常驻后台进程无守护程序随容器启停常驻 dockerd、托盘 GUI无根架构无常驻守护闲置资源占用最低复用现有 WSL2 内核高空闲占用 1GB中等图形可视化界面仅纯 CLI无图形面板完整可视化管理界面可选第三方 GUI命令语法兼容90% Docker 命令通用原生 Docker 标准100% 兼容 Docker 语法GPU/CUDA 支持原生 WSL2 显卡直通开箱即用支持但需额外配置原生支持额外依赖仅依赖已启用的 WSL2内置独立 WSL/Hyper-V 虚拟机依赖 WSL 或本地虚拟机适用项目规模本地单容器开发、临时服务、AI 测试全场景含 Compose、集群、CI 流水线轻量本地开发、无根容器安全场景七、实操踩坑复盘含终端缓存坑完整说明终端缓存致命坑本机实测首要问题执行wsl --update --pre-release后旧终端进程缓存不会加载新增的wslc.exe必须全部关闭终端再新开管理员窗口否则持续报命令不存在仅执行wsl --shutdown无法解决此问题命令混淆坑WSL 系统组件版本wsl --version不存在--get-version容器工具wslc不要误写 wslc.exe version终端可省略 exe 后缀端口映射逻辑-p 主机端口:容器端口规则与 Docker 完全一致Windows 本地可直接curl localhost:端口访问容器内服务多发行版共存不冲突本机同时存在 Ubuntu、podman-machine-default 等 WSL 发行版wslc 使用独立容器运行时不占用现有发行版资源、互不抢占内核预览版功能限制当前为公开预览阶段暂不支持 Docker Compose、自定义复杂网桥网络、持久卷高级挂载多容器联动复杂项目建议搭配 Podman/Docker Desktop 备用。八、典型完整实操示例示例 1本地快速搭建 Nginx 网页服务powershell# 1. 拉取官方Nginx镜像 wslc pull nginx # 2. 后台启动容器端口映射8080 wslc run -d --name demo-nginx -p 8080:80 nginx # 3. Windows浏览器访问http://localhost:8080 # 4. 查看运行状态 wslc ps # 5. 停止并彻底清理容器 wslc stop demo-nginx wslc rm demo-nginx示例 2交互式 Ubuntu 临时开发环境powershell# 拉取22.04稳定镜像 wslc pull ubuntu:22.04 # 进入交互式终端退出容器自动销毁 wslc run --rm -it ubuntu:22.04 bash # 容器内可执行apt、Python、CUDA推理等开发操作九、总结与稳定使用建议wslc 是微软轻量化原生容器替代方案核心优势零额外软件安装、低资源消耗、原生兼容 WSL 显卡加速适合开发人员快速拉起临时测试容器当前处于公开预览阶段功能存在缺失无 Compose、集群、可视化管理能力生产环境 / 多容器编排项目不建议作为主力工具标准化稳定操作流程规避终端缓存报错 管理员终端执行wsl --update --pre-release→wsl --shutdown→关闭全部终端重新新开管理员终端→wsl --version校验内核 →wslc --version校验容器工具多工具共存方案Windows 可同时保留传统 WSL 发行版、podman-machine、wslc 三套环境三者内核运行层隔离无资源冲突可根据项目需求按需切换。【笔记】切换 WSL 到 预览版