.NET 5 平台间互操作变更：非Windows平台不再自动添加A/W后缀

.NET 5 平台间互操作变更：非Windows平台不再自动添加A/W后缀

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

背景知识

在Windows编程中，API函数通常会有两种版本：

• 以"A"结尾的函数：使用ANSI字符集（基于代码页）
• 以"W"结尾的函数：使用Unicode宽字符集（UTF-16）

例如，MessageBoxA和MessageBoxW就是同一API的两种字符集版本。这种命名约定是Windows平台特有的设计。

变更内容

在.NET 5之前，当使用P/Invoke调用本地函数时，CoreCLR和Mono运行时在所有操作系统平台上都会自动尝试添加"A"或"W"后缀来查找函数。这意味着即使在Linux或macOS上，运行时也会先查找带后缀的版本。

从.NET 5开始，这一行为发生了变化：

• Windows平台：保持原有行为，仍然自动添加A/W后缀进行函数查找
• 非Windows平台：不再自动添加A/W后缀，直接使用原始名称查找函数

变更原因

这项变更主要基于以下考虑：

1. A/W后缀是Windows特有的约定，其他操作系统没有这种命名习惯
2. 自动添加后缀会增加不必要的查找开销
3. 提高跨平台行为的一致性，减少意外情况

影响范围

这项变更主要影响：

• 使用P/Invoke调用本地库的.NET应用程序
• 特别是那些在非Windows平台上运行的应用程序
• 依赖自动后缀添加行为的代码

解决方案

如果你的代码需要在非Windows平台上调用带有显式A/W后缀的函数，现在需要显式指定后缀：

// 显式指定W后缀版本
[DllImport("user32.dll", EntryPoint = "MessageBoxW")]
public static extern int MessageBoxW(IntPtr hWnd, string text, string caption, uint type);

或者，更好的做法是使用条件编译来处理平台差异：

#if WINDOWS
[DllImport("user32.dll", EntryPoint = "MessageBox")]
#else
[DllImport("user32.dll")]
#endif
public static extern int MessageBox(IntPtr hWnd, string text, string caption, uint type);

最佳实践

1. 明确指定函数名：在DllImport中显式设置EntryPoint
2. 平台感知：使用RuntimeInformation.IsOSPlatform()检测平台
3. 统一命名：尽可能使用无后缀的函数名
4. 测试验证：在目标平台上充分测试P/Invoke调用

总结

这项变更是.NET 5提高跨平台一致性的一部分，它移除了非Windows平台上不必要的后缀探测行为，使P/Invoke的行为更加符合各平台原生习惯。开发者需要检查现有代码，确保在非Windows平台上的P/Invoke调用能够正确处理函数名后缀问题。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs