Visual Studio WSL CMake项目无法检测启动项的原因与解决

问题描述 #

操作步骤：

• 创建新项目→选择CMake项目
• 选择WSL文件系统路径：\\wsl.localhost\Ubuntu\home\g\project
• Visual Studio成功创建文件，但未自动打开项目
• 手动通过「文件→打开→文件夹」打开\\wsl$\Ubuntu\home\g\project

项目结构：
顶层CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project("wsl_c")

add_subdirectory("wsl_c")

内部wsl_c/CMakeLists.txt：

add_executable(wsl_c "wsl_c.cpp" "wsl_c.h")

if (CMAKE_VERSION VERSION_GREATER 3.12)
  set_property(TARGET wsl_c PROPERTY CXX_STANDARD 20)
endif()

遇到的问题：
项目打开后，启动下拉菜单无目标，提示「请选择有效的启动项」，无法运行或调试。

已知条件：

• 在C:\路径创建相同项目可正常工作
• CMake配置无明显错误
• WSL已安装且正常运行

修复方案 #

1. 确认CMake工具链配置为WSL环境
   打开VS顶部菜单栏的「CMake」→「CMake设置」，检查当前配置是否为WSL-Ubuntu（或对应你的WSL发行版）。如果没有该配置项，点击「添加配置」选择对应的WSL发行版，保存后重新加载项目。

2. 删除CMake缓存并重新生成
   点击「CMake」→「删除缓存并重新生成」，强制VS重新解析WSL路径下的CMakeLists.txt，清除可能存在的缓存异常。

3. 统一WSL路径格式
   创建和打开项目时使用相同的WSL路径格式，比如统一使用\\wsl$\Ubuntu\home\g\project，避免路径格式不一致导致VS识别混乱。

4. 检查WSL目录权限
   打开WSL终端，进入项目目录/home/g/project，执行：

   chmod -R 755 ./
   

   确保所有文件和目录拥有可读可写权限，避免VS访问时出现权限问题。

5. 验证VS的WSL组件完整性
   打开Visual Studio安装器，确认已安装「适用于Linux的C++开发」组件及相关WSL工具。若缺失，补充安装后重启VS。

疑问解答 #

这种情况属于配置问题，并非WSL+VS CMake的已知BUG。核心原因通常是：

• VS默认使用Windows本地CMake环境解析WSL路径项目，无法正确识别WSL环境下的可执行目标；
• CMake缓存未正确生成，导致项目结构解析异常；
• 路径格式混用引发的识别混乱。

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