Visual Studio 2022中Blazor WebAssembly项目缺失IIS Express运行选项求助

一、IIS Express选项缺失的原因 #

• 项目配置异常：托管式Blazor WASM项目依赖ASP.NET Core后端，如果项目文件（.csproj）里误开启了服务端渲染（SSR）配置，会导致IIS Express选项被屏蔽。检查.csproj中是否存在<ServerSideRendering>true</ServerSideRendering>，托管式WASM要确保后端是普通ASP.NET Core站点，而非SSR配置。
• VS组件未安装：Visual Studio的ASP.NET和Web开发工作负载中，IIS Express组件可能未勾选。打开VS安装器，找到“ASP.NET和Web开发”，确认“IIS Express”已安装，没装的话补充安装后重启VS。
• 配置文件损坏：项目的launchSettings.json文件里IIS Express相关配置被删除，或者.vs隐藏目录下的解决方案配置损坏。打开Properties/launchSettings.json，检查是否有以下配置段，缺失的话手动添加，也可以从新建的同类型项目里复制：

  "IIS Express": {
    "commandName": "IISExpress",
    "launchBrowser": true,
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    },
    "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}"
  }
  

• WSL优先级设置：如果系统默认启用了WSL集成，VS会优先显示WSL选项。进入VS的“工具-选项-项目和解决方案-Web项目”，取消勾选“使用WSL进行默认调试启动”，重启后查看是否恢复IIS Express选项。

二、断点无法命中的关联问题 #

• 调试模式未开启：托管式WASM要确保前后端都启用调试。在项目属性的“调试”选项卡中勾选“启用调试”，同时launchSettings.json里的environmentVariables要包含ASPNETCORE_ENVIRONMENT=Development，开发模式下前端的_framework/blazor.boot.json会自动把debug设为true，别手动改成false。
• Release模式代码优化：如果项目处于Release模式，编译器会优化代码，导致断点无法命中。切换到Debug模式重新编译运行。
• 未正确附加调试器：运行项目后，可能需要手动附加浏览器进程。在VS里选“调试-附加到进程”，找到对应的浏览器进程（比如chrome.exe或edge.exe），勾选“WebAssembly代码”选项再附加。

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