修改TargetFramework为何导致HelloWorld无控制台输出？

系统环境 #

• VSCode 1.90.0
• MacOS Sonoma 14.5
• macos workload 14.2.8053/8.0.100
• dotnet SDK 8.0.301

HelloWorld应用 #

通过dotnet new console -n HelloWorld创建应用，项目包含两个文件：

HelloWorld.csproj

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

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

</Project>

Program.cs

// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");

执行dotnet run后控制台正常输出“Hello, World!”。

问题出现 #

使用NAPS2 SDK开发扫描程序时遇到错误：

Unhandled exception. NAPS2.Scan.Exceptions.DriverNotSupportedException:
Unsupported driver: Apple. Make sure you're using the right framework target (e.g. net8-macos10.15 for the Apple driver).

将.csproj的<TargetFramework>改为net8-macos10.15后，又出现错误：

/usr/local/share/dotnet/packs/Microsoft.macOS.Sdk/14.2.8053/tools/msbuild/macOS/Xamarin.Shared.targets(612,3): error : 
A bundle identifier is required. Either add an 'ApplicationId' property in the project file, or add a 'CFBundleIdentifier' entry in the project's Info.plist file.

添加ApplicationId后的.csproj：

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

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8-macos10.15</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <ApplicationId>my.application.ID</ApplicationId>
  </PropertyGroup>

</Project>

执行dotnet run后，扫描程序启动但控制台无输出且冻结；用HelloWorld测试同样配置，控制台也无输出。net8.0-macos10.15同样无效，dotnet restore和dotnet build均成功。

问题 #

为什么将<TargetFramework>从net8.0改为net8-macos10.15会导致HelloWorld无输出？如何解决以便用net8-macos10.15开发扫描应用？

原因分析 #

切换到net8-macos10.15后，项目从跨平台控制台应用转为macOS专属的.app应用包，这类应用默认以GUI模式运行：

1. macOS的.app包本质是GUI应用，启动时不会自动关联终端窗口，Console.WriteLine的输出无法被你执行dotnet run的终端捕获。
2. GUI应用会启动消息循环占用主线程，导致程序执行完输出语句后进入等待状态，看起来像是冻结。

解决方法 #

方法1：强制关联控制台

在.csproj中添加<MacOSForceConsole>true</MacOSForceConsole>属性，让macOS应用强制绑定终端窗口，恢复控制台输出：

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

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8-macos10.15</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <ApplicationId>my.application.ID</ApplicationId>
    <MacOSForceConsole>true</MacOSForceConsole>
  </PropertyGroup>

</Project>

添加后执行dotnet run，终端会正常显示输出，扫描程序也不会冻结。

方法2：输出到日志文件（适合GUI场景）

如果最终要做GUI扫描应用，不需要终端输出，可以将内容写入日志文件：

using System.IO;

// 写入日志文件替代控制台输出
File.WriteAllText("/tmp/scan_log.txt", "Hello, World!");
// 后续扫描逻辑...

通过查看日志文件确认程序执行状态。

方法3：多目标框架编译

保留跨平台控制台特性的同时，添加macOS目标框架：

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

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFrameworks>net8.0;net8.0-macos10.15</TargetFrameworks>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <ApplicationId>my.application.ID</ApplicationId>
  </PropertyGroup>

</Project>

执行dotnet run -f net8.0-macos10.15即可针对macOS编译并保留控制台输出。

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