.Net Core 3.1 _Layout.cshtml使用hostingEnv报CS0841错误如何解决？

常见原因及对应解决方法 #

• 注入指令位置错误
  @inject 指令必须写在你使用 hostingEnv 变量的代码之前，如果你有嵌套的父布局，需要把注入指令写在最先加载的父布局文件顶部，而不是子布局里。另外注意@inject不能包裹在@{ } Razor代码块内部，必须作为独立的行级指令写在文件头部。
• 局部变量命名冲突
  检查你整个布局文件、以及页面中引入的分部视图里，有没有手动声明过同名的hostingEnv局部变量，比如出现var hostingEnv = xxx这类代码，会覆盖注入的全局变量，导致提前引用报错。
• 命名空间引用错误
  如果你没有在_ViewImports.cshtml里全局引入Microsoft.AspNetCore.Hosting命名空间，需要确保注入时的命名空间写全，或者在_ViewImports.cshtml里添加一行@using Microsoft.AspNetCore.Hosting，简化注入代码为@inject IWebHostEnvironment hostingEnv。
• 临时缓存问题
  清理项目的bin、obj文件夹，重启IDE或者执行dotnet clean + dotnet build命令重新编译项目，排除Razor视图缓存导致的异常报错。

替代验证方案 #

如果排查后还是有问题，可以直接用Razor原生的环境标签助手替代代码判断，不需要手动注入环境变量：

<environment include="Development">
    <span>In Development</span>
</environment>

这个标签助手是ASP.NET Core内置的，会自动识别当前运行环境，不需要额外注入变量，更符合官方推荐写法。

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