Go语言编程技巧

Go tips from Phuong Le.

翻译后的站点: Go语言编程技巧 (自动生成)

微信讨论群:

翻译规范

创建一个认领issue,认领标题中注明tip号和标题。不允许一人同时认领多个任务。翻译完一项任务后才能认领下一个任务。
任务请搜索 Phuong Le 的Twitter账号，找到对应的tip，然后翻译成中文。(可能有的tip作者已经删除，经咨询，作者反馈内容会有增删，所以如果某个tip不存在，请空一个，寻找下一个tip)
fork 本项目，然后在 fork 后的项目中进行翻译认领的一个tip,翻译完成后提交pull request
任务请在一周内完成，未完成的任务将被释放，其他人可以认领。

项目自动统计贡献者
翻译请保持语句通顺，可以使用AI协助翻译，但是一定要避免生硬和机翻的感觉

**怎么提交Pull Request? **

如果大家以前没有提交过 Pull Request,可以探索下。首先点击项目右上角的 Fork 按钮，将项目 Fork 到自己的仓库。在github浏览你fork的项目，你会看到一个 "Create pull request" 按钮，点击它填写相关的内容提交即可。后续等待项目的维护者合并你的PR即可。

翻译模板

# Tip #76 函数调用的结果回传

>  原始链接：[Golang Tip #76: Result forwarding in function call](https://twitter.com/func25/status/1779128931586850890)
>

当我刚开始使用go语言的时候，我发现有一个概念比较棘手：函数调用结果的回传。

....

在src下创建翻译文件: xxx.md, 内容模板如上
图片放入 src/images 文件夹中
在 src/SUMMARY.md 文件中加入你翻译的一项
在 README 文件中翻译任务认领表格 填写你翻译的项目

翻译任务认领表格

tip序号	标题	译者
1	Measure the execution time of a function in just one line of code.	smallnest
2	Multistage defer	smallnest
3	Pre-allocate slices for performance	smallnest
4	Parse an Array into a Slice	smallnest
5	Method Chaining	smallnest
6	Underscore Import	icyfire
7	作者已删除
8	Wrapping Errors	icyfire
9	Compile-Time Interface Verification	icyfire
10	Avoid Naked Parameters	smallnest
11	Numeric separators	icyfire
12	Avoid using math/rand, use crypto/rand for keys instead	icyfire
13	Empty slice or, even better, NIL SLICE	icyfire
14	Error messages should not be capitalized or end with punctuation	icyfire
15	When to use Dot (.) Import and Blank (_) Import?	qcrao
16	Don't Return -1 or nil to Indicate Error.	kagaya85
17	Understanding "Return fast, return early" to avoid nested code	icyfire
18	Define interfaces in the consumer package, not the producer	syjs10
19	Avoid named results unless necessary for documentation.	smallnest
20	Pass values, not pointers	smallnest
21	Prefer using a pointer receiver when defining methods	QingyaFan
22	Simplify function signatures with structs or variadic options	zhubiaook
23	Skip the 'Get' prefix for getters	HBUzxl
24	Avoid repetition in naming	smallnest
25	Prefer 'chan struct{}' over 'chan bool' for signaling between goroutines	justlorain
26	Explicitly ignore values with blank identifier (_) instead of silently ignoring them	smallnest
27	Filter without any allocation	devin7788
28	Converting multiple if-else statements into switch cases	zzzpppy
29	Avoid context.Background(), make your goroutines promisable.	stonemax
30	Keep contexts going with context.WithoutCancel()	smallnest
31	Loop labels for cleaner breaks and continues	zhubiaook
32	Scheduling functions after context cancellation with context.AfterFunc	LinPr,smallnest
33	Just... Don’t Panic()	baxiang
34	Lead with context, end with options, and always close with an error	lylex
35	Prefer strconv over fmt for converting to/from string	jjjjjim
36	Naming Unexported Global Variables with an Underscore (_) Prefix	baxiang
37	Using Unexported Empty Struct as Context Key	baxiang
38	Make your errors clear with fmt.Errorf, don't just leave them bare	smallnest
39	Avoid defer in loops, or your memory might blow up	devin7788
40	Handle errors while using defer to prevent silent failures	smallnest
41	Sort your fields in your struct from largest to smallest	justlorain
42	Single Touch Error Handling, Less Noise.	zhubiaook
43	Gracefully Shut Down Your Application	LinPr,smallnest
44	Intentionally Stop with Must Functions	syjs10
45	Always Manage Your Goroutine Lifetime.	stonemax
46	Avoid using break in switch cases, except when paired with labels	baxiang
47	Table-driven tests, subtests, and parallel tests	devin7788
48	Avoid Global Variables, Especially Mutable Ones.	vcheckzen
49	Give the Caller the Right to Make Decisions	vcheckzen
50	Make Structs Non-comparable.	smallnest
51	Avoid using init()	richzw
52	Adjusting GOMAXPROCS for Containerized Env (Kubernetes, Docker, etc.)	baxiang
53	Enums start from 1 for categorization and 0 for default cases	baxiang
54	Only define errors (var Err = errors.New) when it's necessary for your client	lylex
55	Prevent Struct Unkeyed Literals by Using an Empty Field	cannian1
56	Simplify interfaces and only ask for what you really need	cannian1
57	Golang Tip #57: Flag Enums in Go	baxiang
58	Keep the mutex close to the data it's protecting	richzw
59	If a parameter isn't needed, either drop it or ignore it on purpose	TravisRoad
60	sync.Once is the best way to do things once	smallnest
61	Making a Type with Built-In Locking (sync.Mutex embedding)	richzw
62	context.Value is not our friend	hawkinggg
63	Avoid time.Sleep(), it's not context-aware and can't be interrupted	richzw
64	Make main() clean and testable.	syjs10
65	Returning Pointers Made Easy with Generics	miniLCT
66	Simplify Your Error Messages in fmt.Errorf	smallnest
67	How to deal with long function signatures	richzw
68	Use the deadcode tool to find and remove unused functions	richzw
69	Manage multiple goroutines with errgroup	richzw
70	Implement a context-aware sleep function	hxzhouh
71	sync.Pool, make it typed-safe with generics	QingyaFan
72	Case-Insensitive string comparison with strings.EqualFold	syjs10
73	Implement String() for enum with the stringer tool	syjs10
74	Make time.Duration clear and easy to understand	richzw
75	Optimize multiple calls with singleflight	hxzhouh
76	Result forwarding in function calls	syjs10
77	Buffered channels as semaphores to limit goroutine execution	QingyaFan
78	Non-blocking channel send trick	hxzhouh
79	If doing something unusual, comment why	smallnest
80	Declare variables NEAR their usage	smallnest
81	To check if a string is empty, prefer s != "" over len(s) == 0	smallnest
82	Enhance Debug Output with %+v and %q Instead of %v and %s	smallnest

生成文档

如果你想在本地编译，请安装mdbook工具。

本地预览

在本地mdbook serve可以生成本地网站访问。

http://localhost:3000

生成静态网站

mdbook build 生成网站到book目录下。

贡献者 ✨

_smallnest 💻	_hxzhouh 💻	_icyfire 💻	_JS 💻	_richzw 💻	_cheerfun 💻	_rkmdsxmds 💻
_devin7788 💻	_Cannian 💻	_{LU XIUYUAN} 💻	_zzzpppy 💻	_Kagaya 💻	_{Zhang Jinlong} 💻	_HBUzxl 💻
_羊羽 💻	_zhubiaook 💻	_LOGI 💻	_Lorain 💻	_lylex 💻	_Lin 💻	_qcrao 💻
_ryan961 💻	_Ekko 💻	_whoops 💻