update: update gpa to DebugAllocator in learn module by lennlouisgeek · Pull Request #119 · zigcc/zigcc.github.io

lennlouisgeek · 2026-07-12T10:59:27Z

Removestd.heap.GeneralPurposeAllocator,update to std.heap.DebugAllocator in learn module.

gemini-code-assist

Code Review

This pull request updates the Zig tutorial documentation to replace the deprecated GeneralPurposeAllocator with the new DebugAllocator for Zig 0.16.0. However, the reviewer identified a widespread syntax error: std.heap.DebugAllocator is a struct rather than a generic function, meaning that initializing it with (.{}){} will result in a compilation error; it should be initialized directly as std.heap.DebugAllocator{}. Additionally, several explanations and Chinese translations in the documentation still incorrectly describe it as a generic function or refer to it as the "General Purpose Allocator" and need to be corrected.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

gemini-code-assist · 2026-07-12T11:01:36Z

+	var dpa = std.heap.DebugAllocator(.{}){};
+	const allocator = dpa.allocator();


In Zig, std.heap.DebugAllocator is a struct, not a generic function that takes a configuration parameter. Therefore, calling it with (.{}) is a compile error. It should be initialized directly as std.heap.DebugAllocator{}.

var dpa = std.heap.DebugAllocator{}; const allocator = dpa.allocator();

gemini-code-assist · 2026-07-12T11:01:36Z

+	var dpa = std.heap.DebugAllocator(.{}){};
+	const allocator = dpa.allocator();


In Zig, std.heap.DebugAllocator is a struct, not a generic function that takes a configuration parameter. Therefore, calling it with (.{}) is a compile error. It should be initialized directly as std.heap.DebugAllocator{}.

var dpa = std.heap.DebugAllocator{}; const allocator = dpa.allocator();

gemini-code-assist · 2026-07-12T11:01:36Z

+	var dpa = std.heap.DebugAllocator(.{}){};
+	const allocator = dpa.allocator();


In Zig, std.heap.DebugAllocator is a struct, not a generic function that takes a configuration parameter. Therefore, calling it with (.{}) is a compile error. It should be initialized directly as std.heap.DebugAllocator{}.

var dpa = std.heap.DebugAllocator{}; const allocator = dpa.allocator();

gemini-code-assist · 2026-07-12T11:01:36Z

+	var dpa = std.heap.DebugAllocator(.{}){};
+	const allocator = dpa.allocator();


In Zig, std.heap.DebugAllocator is a struct, not a generic function that takes a configuration parameter. Therefore, calling it with (.{}) is a compile error. It should be initialized directly as std.heap.DebugAllocator{}.

var dpa = std.heap.DebugAllocator{}; const allocator = dpa.allocator();

gemini-code-assist · 2026-07-12T11:01:36Z

+	var dpa = std.heap.DebugAllocator(.{}){};
+	const allocator = dpa.allocator();


In Zig, std.heap.DebugAllocator is a struct, not a generic function that takes a configuration parameter. Therefore, calling it with (.{}) is a compile error. It should be initialized directly as std.heap.DebugAllocator{}.

var dpa = std.heap.DebugAllocator{}; const allocator = dpa.allocator();

gemini-code-assist · 2026-07-12T11:01:36Z

+你可能会注意到，创建 `dpa` 的语法有点奇怪。什么是`DebugAllocator(.{}){}`？

-我们之前见过这些东西，只是现在都混合了起来。`std.heap.GeneralPurposeAllocator` 是一个函数，由于它使用的是 `PascalCase`（帕斯卡命名法），我们知道它返回一个类型。（下一部分会更多讨论泛型）。也许这个更明确的版本会更容易解读：
+我们之前见过这些东西，只是现在都混合了起来。`std.heap.DebugAllocator` 是一个函数，由于它使用的是 `PascalCase`（帕斯卡命名法），我们知道它返回一个类型。（下一部分会更多讨论泛型）。也许这个更明确的版本会更容易解读：

 ```zig
-const T = std.heap.GeneralPurposeAllocator(.{});
-var gpa = T{};
+const T = std.heap.DebugAllocator(.{});
+var dpa = T{};

 // 等同于：

-var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+var dpa = std.heap.DebugAllocator(.{}){};
 ```


Since std.heap.DebugAllocator is a struct and not a generic function, the explanation about DebugAllocator(.{}){} being a function that returns a type is incorrect and misleading. We should update this section to explain that it is a simple struct initialized with {}.

Note that since DebugAllocator is a simple struct and does not use std.heap.general_purpose_allocator.Config, the subsequent paragraph (around line 302 in the original file) explaining Config and default values is also obsolete and should be removed or updated in a separate change.

Suggested replacement:

创建 dpa 的语法非常简单：std.heap.DebugAllocator{}。因为 DebugAllocator 是一个结构体（struct），而不是像以前的 GeneralPurposeAllocator 那样是一个返回类型的泛型函数，所以我们不需要传递配置参数，直接实例化即可：

var dpa = std.heap.DebugAllocator{};

gemini-code-assist · 2026-07-12T11:01:36Z

 ## [std.testing.allocator]($heading.id('std-testing-allocator'))

-希望当我们谈到内存泄漏时，你已经足够烦恼，而当我提到 Zig 可以提供帮助时，你肯定渴望了解更多这方面内容。这种帮助来自 `std.testing.allocator`，它是一个 `std.mem.Allocator` 实现。目前，它基于通用分配器（GeneralPurposeAllocator）实现，并与 Zig 的测试运行器进行了集成，但这只是实现细节。重要的是，如果我们在测试中使用 `std.testing.allocator`，就能捕捉到大部分内存泄漏。
+希望当我们谈到内存泄漏时，你已经足够烦恼，而当我提到 Zig 可以提供帮助时，你肯定渴望了解更多这方面内容。这种帮助来自 `std.testing.allocator`，它是一个 `std.mem.Allocator` 实现。目前，它基于通用分配器（DebugAllocator）实现，并与 Zig 的测试运行器进行了集成，但这只是实现细节。重要的是，如果我们在测试中使用 `std.testing.allocator`，就能捕捉到大部分内存泄漏。


The Chinese text still refers to DebugAllocator as "通用分配器" (General Purpose Allocator). It should be updated to "调试分配器" (Debug Allocator) to match the new allocator name.

Suggested replacement:

希望当我们谈到内存泄漏时，你已经足够烦恼，而当我提到 Zig 可以提供帮助时，你肯定渴望了解更多这方面内容。这种帮助来自 std.testing.allocator，它是一个 std.mem.Allocator 实现。目前，它基于调试分配器（DebugAllocator）实现，并与 Zig 的测试运行器进行了集成，但这只是实现细节。重要的是，如果我们在测试中使用 std.testing.allocator，就能捕捉到大部分内存泄漏。

gemini-code-assist · 2026-07-12T11:01:36Z

+	var dpa = std.heap.DebugAllocator(.{}){};
+	const allocator = dpa.allocator();


In Zig, std.heap.DebugAllocator is a struct, not a generic function that takes a configuration parameter. Therefore, calling it with (.{}) is a compile error. It should be initialized directly as std.heap.DebugAllocator{}.

var dpa = std.heap.DebugAllocator{}; const allocator = dpa.allocator();

gemini-code-assist · 2026-07-12T11:01:36Z

+var dpa = std.heap.DebugAllocator(.{}){};
+const allocator = dpa.allocator();


In Zig, std.heap.DebugAllocator is a struct, not a generic function that takes a configuration parameter. Therefore, calling it with (.{}) is a compile error. It should be initialized directly as std.heap.DebugAllocator{}.

var dpa = std.heap.DebugAllocator{}; const allocator = dpa.allocator();

gemini-code-assist · 2026-07-12T11:01:36Z

+var dpa = std.heap.DebugAllocator(.{}){};
+const allocator = dpa.allocator();


In Zig, std.heap.DebugAllocator is a struct, not a generic function that takes a configuration parameter. Therefore, calling it with (.{}) is a compile error. It should be initialized directly as std.heap.DebugAllocator{}.

var dpa = std.heap.DebugAllocator{}; const allocator = dpa.allocator();

Copilot

Pull request overview

This PR updates the learn-module documentation examples to stop using std.heap.GeneralPurposeAllocator and instead demonstrate std.heap.DebugAllocator, aligning the tutorial with newer Zig standard library allocator naming/usage.

Changes:

Replaced GeneralPurposeAllocator usages in code snippets with DebugAllocator (gpa → dpa) across learn articles.
Updated headings and explanatory text in the heap-memory lesson to describe DebugAllocator.
Adjusted allocator-related examples and surrounding narrative to match the new allocator choice.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File	Description
content/learn/heap-memory.smd	Updates allocator section (heading, narrative, and multiple code snippets) to use `DebugAllocator` instead of `GeneralPurposeAllocator`.
content/learn/generics.smd	Updates the allocator instantiation in the generics example to use `DebugAllocator`.
content/learn/coding-in-zig.smd	Updates multiple code examples to use `DebugAllocator` in place of `GeneralPurposeAllocator`.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

-顾名思义，`std.heap.GeneralPurposeAllocator` 是一种通用的、线程安全的分配器，可以作为应用程序的主分配器。对于许多程序来说，这是唯一需要的分配器。程序启动时，会创建一个分配器并传递给需要它的函数。我的 HTTP 服务器库中的示例代码就是一个很好的例子：
+顾名思义，`std.heap.DebugAllocator` 是一种针对调试和安全检查的分配器。程序启动时，会创建一个分配器并传递给需要它的函数。我的 HTTP 服务器库中的示例代码就是一个很好的例子：
+
+> 需要注意的是：zig在0.16.0之前是有一个`GeneralPurposeAllocator`即通用分配器的，但是在0.16.0时彻底移除了这个分配器，减少了活动映射的数量，从而提高了性能。


+const T = std.heap.DebugAllocator(.{});
+var dpa = T{};

 // 等同于：



 ## [std.testing.allocator]($heading.id('std-testing-allocator'))

-希望当我们谈到内存泄漏时，你已经足够烦恼，而当我提到 Zig 可以提供帮助时，你肯定渴望了解更多这方面内容。这种帮助来自 `std.testing.allocator`，它是一个 `std.mem.Allocator` 实现。目前，它基于通用分配器（GeneralPurposeAllocator）实现，并与 Zig 的测试运行器进行了集成，但这只是实现细节。重要的是，如果我们在测试中使用 `std.testing.allocator`，就能捕捉到大部分内存泄漏。
+希望当我们谈到内存泄漏时，你已经足够烦恼，而当我提到 Zig 可以提供帮助时，你肯定渴望了解更多这方面内容。这种帮助来自 `std.testing.allocator`，它是一个 `std.mem.Allocator` 实现。目前，它基于通用分配器（DebugAllocator）实现，并与 Zig 的测试运行器进行了集成，但这只是实现细节。重要的是，如果我们在测试中使用 `std.testing.allocator`，就能捕捉到大部分内存泄漏。


 const httpz = @import("httpz");

 pub fn main() !void {
 	// create our general purpose allocator


jiacai2050 · 2026-07-12T11:38:35Z

请按照英文原文进行适配，那边已经适配0.16了

…earning_zig

lennlouisgeek · 2026-07-12T14:09:11Z

Fixed, please review again.

update: update gpa to DebugAllocator in learn module

c7dee9e

lennlouisgeek requested review from jiacai2050, jinzhongjia and xihale as code owners July 12, 2026 10:59

gemini-code-assist Bot reviewed Jul 12, 2026

View reviewed changes

jiacai2050 requested a review from Copilot July 12, 2026 11:24

Copilot started reviewing on behalf of jiacai2050 July 12, 2026 11:24 View session

Copilot AI reviewed Jul 12, 2026

View reviewed changes

update:update coding-in-zig generics heap-memory to 0.16.0 based on l…

7f3fe10

…earning_zig

		var dpa = std.heap.DebugAllocator(.{}){};
		const allocator = dpa.allocator();

Uh oh!

Conversation

lennlouisgeek commented Jul 12, 2026

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Jul 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

jiacai2050 commented Jul 12, 2026

Uh oh!

lennlouisgeek commented Jul 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants