「零基础转行工业 3D 视觉」系列第一篇。本文记录我用 WorkBuddy 把第 1 周环境搭起来的完整过程3 个步骤手动敲的命令不超过 3 条。全程用到的 3 个脚本放在文末附件里可以直接下载复用。开始之前一条最重要的提醒不要装 VMware也不要装 VirtualBox。它们会和 WSL2 抢 CPU 的虚拟化层Hyper-V轻则 WSL2 启动报0x80370102重则蓝屏 / kernel panic —— 这也是我学习计划里明确写着「不用 VirtualBox」的原因。已经装了的建议先卸载再往下走。本文最终装出来的版本版本对不上会多踩很多坑先列清楚组件版本来源宿主系统Windows 11 23H2Build 22631—WSLWSL2wsl --update发行版Ubuntu 22.04.5 LTS (Jammy)微软商店PCL1.12.1Ubuntu 22.04 官方源OpenCV4.5.4同上Eigen3.4.0同上Ceres2.0.0同上Open3Dpip 最新版独立虚拟环境划重点Ubuntu 22.04 的 apt 源里 PCL 正好是1.12直接apt install libpcl-dev就行完全不用源码编译。第 1 步让 WorkBuddy 先检查 Windows 系统我没急着动手而是先把需求和学习计划发给 WorkBuddy让它先看看我这台机器能不能装、该怎么装。我发给它的话根据我的转行学习计划我需要在本周完成第 1 周环境搭建WSL2 安装 Ubuntu 22.04不用 VirtualBox避免 kernel panic安装 PCL 1.12、OpenCV 4.x、Eigen、Ceres、Open3D其中指导我进行 Ubuntu 的安装尽量安装在 D 盘我的文件夹的 softwares 中它查到的由此定的决策系统实际是Windows 11 23H2Build 22631但注册表ProductName显示 “Windows 10 Pro”以 Build 号为准。Win11 自带 WSLg图形界面直接可用不用额外装 X ServerC 盘 200 GB只剩 75 GBD 盘 753 GB 剩 222 GBUbuntu必须装 D 盘ext4.vhdx只增不减会一路把 C 盘吃干wsl.exe存在但没装任何发行版全新安装脚本可以直接跑第 2 步一键安装 WSL2 Ubuntu 22.04以管理员身份打开 PowerShell开始菜单搜 PowerShell → 右键 → 以管理员身份运行执行一条命令powershell-ExecutionPolicy Bypass-FileD:\Mengyuan\Softwares\scripts\01-install-wsl2-ubuntu2204.ps1脚本会依次做 5 件事可重复运行已完成的自动跳过步骤它自动做的【1/5】开启「适用于 Linux 的 Windows 子系统」「虚拟机平台」两个 Windows 功能并提示重启【2/5】重启后wsl --update升级内核默认版本设为 WSL2【3/5】安装 Ubuntu 22.04落到D:\Mengyuan\Softwares\WSL\Ubuntu-22.04【4/5】写C:\Users\你\.wslconfig限制内存/CPU防止后续编译时把 Windows 卡死【5/5】验证打印发行版列表确认ext4.vhdx真的在 D 盘全程只有一处需要你动手中途会弹出 Ubuntu 终端让你创建账号、输入密码。Enter new UNIX username: mengyuan # 全小写英文别用中文、别用大写 New password: ******** # 输入时屏幕不显示字符这是正常的 Retype new password: ********小插曲我输administrator结果首字母被提示符吃掉变成了dministrator。问了 WorkBuddy说这是终端交互的常见现象、功能完全不受影响继续用就行 —— 省了我一次重装。重点看三行* Ubuntu-22.04 Stopped 2 - VERSION 必须是 2 [√] 虚拟磁盘已落在 D 盘D:\Mengyuan\Softwares\WSL\Ubuntu-22.04\ext4.vhdx当前 1.35 GB会随使用增长 全部完成脚本里的一个关键设计它预设了两条安装路径。优先用wsl --install --location一步装到 D 盘如果当前 WSL 版本不支持--location自动降级为「装到 C 盘 → 导出 → 注销 → 导入到 D 盘」。我这台机器的 WSL 版本不支持--location于是它自己走了降级路径我全程无感。第 3 步一键安装 PCL / OpenCV / Eigen / Ceres / Open3D进入 Ubuntu任意终端输入wsl回车运行一条命令bash/mnt/d/Mengyuan/Softwares/scripts/02-setup-dev-env.sh脚本依次做 5 件事同样可重复运行步骤它自动做的【1/5】切换 apt 源到清华 TUNA 镜像自动备份原文件国内下载提速 10 倍以上【2/5】安装编译链 PCL 1.12 / OpenCV 4.5 / Eigen 3.4 / Ceres 2.0【3/5】Open3D 装进独立虚拟环境~/venvs/py3d不污染系统 Python【4/5】校验 WSLg 图形环境【5/5】打印版本核对表逐项对照学习计划下载量约 12 GB5~~15 分钟。装完的关键输出能看到这两行就说明 PCL 装上了Setting up libpcl-dev (1.12.1dfsg-3build1) ... Setting up libvtk9-dev (9.1.0really9.1.0dfsg2-3build1) ...Setting up是 apt 安装的最后一个阶段解包之后的配置它出现在所有依赖处理完之后 —— 看到它基本就是成功了。最后脚本还会打印一张版本核对表----------------------------------------------------------- PCL 1.12.1-1 计划要求 1.12 OpenCV 4.5.4dfsg 计划要求 4.x Eigen 3.4.0-4 Ceres 2.0.0dfsg1-5build1 CMake 3.22.1 GCC 11.4.0 Open3D 0.18.0 -----------------------------------------------------------为什么不用源码编译 PCLUbuntu 22.04 官方源里正好是 1.12直接 apt 装即可。源码编译要多花 1~2 小时还容易挂在 VTK / Qt 依赖上 —— 新手第一周纯属自找麻烦。附件3 个脚本在资源里对应直接拿去用哈附件文件用途怎么用01-install-wsl2-ubuntu2204.ps1Windows 侧一键装 WSL2 把 Ubuntu 22.04 装到 D 盘管理员 PowerShell 运行02-setup-dev-env.shUbuntu 侧一键装 PCL / OpenCV / Eigen / Ceres / Open3D在 Ubuntu 里执行run-stage-b-env.cmd双击启动器免敲命令直接跑上面那个.sh双击即可只有 2 个地方需要改成你自己的位置改成01-install-wsl2-ubuntu2204.ps1里的$InstallRoot你想装的目录run-stage-b-env.cmd里的脚本路径你的脚本实际位置跨平台存放行尾要注意不然会报$\r: command not found文件类型行尾 / 编码.ps1UTF-8 with BOM.shLF.cmdCRLF结尾WSL2 Ubuntu 22.04 装在 D 盘PCL 全套依赖就位啦下一篇PCL 核心算法手写VoxelGrid / SOR / RANSAC / ICP。本文首发于 CSDN是「零基础转行工业 3D 视觉」系列第一篇转载请注明出处。