Windows：优先使用原生API而非Win32

[cers000]

https://codeberg.org/ziglang/zig/issues/31131

[gemini-code-assist]

Summary of Changes

Hello @cers000, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

此拉取请求新增了一篇博文，详细阐述了Zig语言在Windows平台上关于API使用策略的重大调整。该文章深入探讨了为何Zig项目决定优先采用更底层的Native API而非传统的Win32 API，并权衡了这一决策带来的优势与潜在挑战，为开发者提供了清晰的指导和背景信息。

Highlights

• 核心策略调整: Zig项目在Windows平台将优先使用更底层的Native API（ntdll.dll）而非传统Win32 API（kernel32.dll）。
• 主要优势: 采用Native API可带来性能提升、更强的功能、减少对Win32 DLL的依赖以及更灵活的错误处理。
• 潜在风险: 承认了Native API缺乏文档、存在变更风险、可能影响旧版Windows和Wine兼容性，以及可能被安全软件误报的风险。
• 替换原则: 明确了哪些Win32函数可被Native API替换（如ABI兼容的转发器、简单包装器），以及哪些因复杂性暂不替换（如控制台API、Winsock API）。
• 社区疑虑回应: 回应了关于Win32函数移除、旧版Windows兼容性、Wine支持和Native API变更等常见问题。

Changelog

• content/post/2026-2-13-Prefer the Native API over Win32
  • 新增了一篇关于Windows API策略的博文。

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

这篇博文对 Zig 社区的一个重要技术决策进行了清晰的总结，内容翔实，结构合理。我提出了一些关于措辞和格式的微小建议，以提高文章的可读性和专业性。另外，建议将文件名中的空格替换为连字符（-），例如 '2026-2-13-prefer-the-native-api-over-win32'，以避免在某些系统或URL处理中可能出现的问题。

[gemini-code-assist]

标题（h2, h3, h4）默认已经有加粗或放大的样式，在 Markdown 源文件中再用 **...** 对标题文字进行加粗是多余的。为了保持 Markdown 源码的简洁性，建议移除标题中的 **。这个建议也适用于文中的所有标题（如第12、23、32、41、54、60行）。

## 摘要

[gemini-code-assist]

这里的“特殊工作区”读起来有些生硬，似乎是 "workaround" 的直译。为了更符合中文技术语境，建议使用“权宜之计”、“变通方法”或“特殊处理”等词语。

    *   **答：** 我们视其为Wine的bug。除非严重影响CI测试，否则不会主动为Wine添加权宜之计。

[gemini-code-assist]

“未充分文档API”的表述略显西化，可以调整为更自然的中文表达，例如“文档不全的API”或“缺少文档的API”。

这篇Issues不仅仅是一个技术讨论，它清晰地阐述了 Zig 在系统编程语言定位下的一个具体决策：**为了追求更高的性能、更强的能力和更简洁的代码，宁愿承担使用文档不全的API的风险，也要尽可能地接近操作系统底层**。

[gemini-code-assist]

当前的引用格式将链接的URL作为链接文本显示了出来，造成了信息重复。建议将文章标题作为链接文本，使引用更简洁、专业。

1. [Windows: Prefer the Native API over Win32  · Issue #31131 · ziglang/zig - Codeberg](https://codeberg.org/ziglang/zig/issues/31131), accessed 2026年2月6日.

[jiacai2050]

@cers000 请按照 gemini review 意见修改。谢谢。