VS2022切换至WSL2实例失败：Echo命令执行出错

问题详情 #

• 环境：VS2022 + CMake，长期使用的WSL2 Ubuntu-20.04实例（用于C++构建），目标是通过VS2022进行Linux平台开发
• 现象：VS2022启动时能识别并列出Ubuntu-20.04实例，但选择该实例后连接失败，报错：Failed to change target system to 'WSL: Ubuntu-20.04': Echo command failing
• 已排查动作：
  • 查看%APP_DATA%\Microsoft\VisualStudio\SettingsLogs未找到有效调试信息
  • 启用跨平台日志后，仅能看到VS尝试发送echo命令但超时失败的记录

20240806更新：跨平台日志内容 #

13:02:20.1424797 [Info, Thread 125] liblinux.Local.Services.WslEnumerator: Begin executing: C:\WINDOWS\System32\wsl.exe --list --verbose
13:02:20.6617777 [Info, Thread 128] liblinux.Local.Services.WslEnumerator: End executing: C:\WINDOWS\System32\wsl.exe; exitcode: 0; duration: 00:00:00.5202963
13:02:20.6617777 [Info, Thread 133] liblinux.Local.Shell.WindowsSubsystemShell: Connecting to shell at "C:\WINDOWS\System32\wsl.exe"
13:02:20.7549560 [Info, Thread 133] liblinux.Local.Shell.WindowsSubsystemShell: VerifyEcho sentinel:17ea8c27-d41f-44cc-a029-dfe6f9bece4c id:fcb0004b-0953-4c2c-8c94-d9b30467b6cb
13:02:20.7549560 [Info, Thread 133] liblinux.Local.Shell.WindowsSubsystemShell: Writing "echo 17ea8c27-d41f-44cc-a029-dfe6f9bece4c" to the fcb0004b-0953-4c2c-8c94-d9b30467b6cb shell
13:02:20.7549560 [Info, Thread 117] liblinux.Local.Shell.WindowsSubsystemShell: Read async: fcb0004b-0953-4c2c-8c94-d9b30467b6cb
13:04:20.7811861 [Info, Thread 133] liblinux.Local.Shell.WindowsSubsystemShell: VerifyEcho failed fcb0004b-0953-4c2c-8c94-d9b30467b6cb
13:04:20.7811861 [Info, Thread 133] liblinux.Local.Shell.WindowsSubsystemShell: Connecting to shell at "C:\WINDOWS\System32\wsl.exe"
13:04:20.8947299 [Info, Thread 133] liblinux.Local.Shell.WindowsSubsystemShell: VerifyEcho sentinel:91744b73-d804-476e-a3f1-615091351389 id:fcb0004b-0953-4c2c-8c94-d9b30467b6cb
13:04:20.8947299 [Info, Thread 92]  liblinux.Local.Shell.WindowsSubsystemShell: Read async: fcb0004b-0953-4c2c-8c94-d9b30467b6cb
13:04:20.8947299 [Info, Thread 133] liblinux.Local.Shell.WindowsSubsystemShell: Writing "echo 91744b73-d804-476e-a3f1-615091351389" to the fcb0004b-0953-4c2c-8c94-d9b30467b6cb shell
13:05:20.9045208 [Info, Thread 133] liblinux.Local.Shell.WindowsSubsystemShell: VerifyEcho failed fcb0004b-0953-4c2c-8c94-d9b30467b6cb

排查与解决建议 #

• 手动验证WSL实例的echo功能：在CMD中执行wsl -d Ubuntu-20.04 echo test，确认是否能正常输出结果。如果失败，直接运行wsl -d Ubuntu-20.04进入实例终端，检查系统是否能正常启动、命令是否可执行。
• 配置WSL默认用户：若WSL启动时需要手动输入用户名/密码，会导致VS无法自动连接。执行ubuntu2004 config --default-user <你的用户名>设置默认登录用户。
• 重置WSL实例：运行wsl --shutdown关闭所有WSL实例，重新启动Ubuntu-20.04后再尝试连接；同时检查网络连通性，执行wsl -d Ubuntu-20.04 ping 8.8.8.8确认网络正常。
• 检查VS2022组件：确保已安装Linux开发工作负载和适用于Linux的C++ CMake工具，可通过VS Installer修改安装项。
• 获取更详细的调试日志：
  1. 打开VS2022的工具 > 选项 > 跨平台 > 日志记录，将日志级别设为「详细」或「诊断」
  2. 日志文件可在%TEMP%\VisualStudio\Logs\目录下查找，重点关注包含「WSL」「Linux」关键字的文件
  3. 也可通过命令行启动VS生成指定日志：devenv /log "%USERPROFILE%\Desktop\vs_wsl_debug.log"

内容的提问来源于stack exchange，提问作者stafla