如何在.NET8 Blazor项目中生成js.map文件？

一、自定义JavaScript代码生成js.map文件 #

• 右键项目中自定义JS文件（通常在wwwroot/js目录下），选择属性。
• 在属性窗口将生成操作设为Content，复制到输出目录设为如果较新则复制。
• 若用第三方打包工具（如Vite、Webpack），在配置文件开启sourcemap生成：Vite设置build.sourcemap: true，Webpack设置devtool: 'source-map'；若为原生手写JS，可在VS的「工具>选项>文本编辑器>JavaScript/TypeScript>语言服务」中勾选「生成source map」。

二、获取Blazor自身相关的js.map文件 #

Blazor框架自带脚本（如_blazor.webassembly.js、_framework/blazor.*.js）的map文件，可通过以下两种方式获取：

• 从NuGet包提取：找到项目依赖的Microsoft.AspNetCore.Components.WebAssembly包（路径通常为%userprofile%\.nuget\packages\microsoft.aspnetcore.components.webassembly\8.x.x\wwwroot\_framework），复制其中的.js.map文件到项目wwwroot/_framework目录，部署时一并上传服务器。
• 调整项目构建配置：在项目.csproj文件中添加以下配置，强制构建时生成框架sourcemap文件：

<PropertyGroup>
  <BlazorEnableSourceMaps>true</BlazorEnableSourceMaps>
</PropertyGroup>

添加后重新构建项目，框架相关js.map文件会生成到输出目录的_framework文件夹中。

三、部署时的注意事项 #

• 检查发布配置：在Visual Studio发布配置的「文件发布选项」中，取消勾选「排除生成的调试符号」；或在.pubxml发布配置文件中添加：

<PropertyGroup>
  <ExcludeGeneratedDebugSymbol>false</ExcludeGeneratedDebugSymbol>
</PropertyGroup>

• 若使用Azure App Service等托管服务，确认部署策略（如Zip部署）未遗漏map文件。

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