Visual Studio for Mac 2019全局引用报错及设置找不到问题

问题概述 #

基于.NET 6.0.106的项目构建时触发CS0116编译错误，同时在Visual Studio for Mac Community(v8.10.25(build 2))中找不到Windows版Visual Studio里的「Global Usings」配置选项，需排查原因并解决。

编译错误详情 #

BuildingPassport/HousePassport.Domain/obj/Debug/net6.0/HousePassport.Domain.GlobalUsings.g.cs(1,1): Error CS0116: A namespace cannot directly contain members such as fields or methods (CS0116) (HousePassport.Domain)

自动生成的全局引用文件内容 #

自动生成的HousePassport.Domain.GlobalUsings.g.cs代码：

// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;

开发环境详情 #

Visual Studio Community 2019 for Mac
Version 8.10.25 (build 2)
Installation UUID: 78cd4d01-f097-4a1a-9faf-b2ee9edbfae3
    GTK+ 2.24.23 (Raleigh theme)
    Xamarin.Mac 6.18.0.23 (d16-6 / 088c73638)

    Package version: 612000182

Mono Framework MDK
Runtime:
    Mono 6.12.0.182 (2020-02/6051b710727) (64-bit)
    Package version: 612000182

Roslyn (Language Service)
3.10.0-4.21269.26+029847714208ebe49668667c60ea5b0a294e0fcb

NuGet
Version: 5.9.0.7134

.NET SDK (x64)
SDK: /usr/local/share/dotnet/x64/sdk/6.0.106/Sdks
SDK Versions:
    6.0.106
    5.0.408
    3.1.420
MSBuild SDKs: /Applications/Visual Studio.app/Contents/Resources/lib/monodevelop/bin/MSBuild/Current/bin/Sdks

.NET Core Runtime
Runtime: /usr/local/share/dotnet/x64/dotnet
Runtime Versions:
    6.0.6
    5.0.17
    3.1.26
Operating System

Mac OS X 13.0.1
Darwin 22.1.0 Darwin Kernel Version 22.1.0
    Sun Oct  9 20:14:30 PDT 2022
    root:xnu-8792.41.9~2/RELEASE_ARM64_T8103 x86_64

项目配置文件（.csproj） #

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>

原因分析 #

1. CS0116错误原因：当前使用的Visual Studio 2019 for Mac配套Roslyn编译器版本为3.10.0，该版本对.NET 6引入的global using语法支持存在缺陷，即便自动生成的代码语法正确，编译器仍会误判代码结构抛出错误。
2. 「Global Usings」选项缺失原因：Visual Studio 2019 for Mac未提供该UI配置选项，「Global Usings」是Visual Studio 2022 for Mac才新增的功能，用于可视化管理.NET 6+的隐式全局引用。

解决办法 #

方案1：升级Visual Studio for Mac到2022版本 #

• 旧版VS 2019 for Mac对.NET 6兼容性有限，升级到2022版后：
  • 自动更新Roslyn编译器至支持.NET 6的版本，彻底解决CS0116编译错误；
  • 获得「Global Usings」可视化配置入口，可直接在项目选项中管理全局引用。

方案2：手动修改项目配置（无需升级IDE） #

子方案2.1：关闭隐式全局引用

编辑项目的.csproj文件，将<ImplicitUsings>enable</ImplicitUsings>修改为：

<ImplicitUsings>disable</ImplicitUsings>

修改后IDE不再自动生成GlobalUsings.g.cs文件，避免编译器误判。

子方案2.2：手动添加全局引用文件

若仍需全局引用功能，关闭隐式引用后，在项目根目录新建GlobalUsings.cs文件，写入以下内容：

global using System;
global using System.Collections.Generic;
global using System.IO;
global using System.Linq;
global using System.Net.Http;
global using System.Threading;
global using System.Threading.Tasks;

方案3：验证修复效果 #

修改完成后，清理项目的obj和bin目录，重新构建项目，确认CS0116错误消失。

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