smallnest
💻
hxzhouh
💻
icyfire
💻
JS
💻
richzw
💻
cheerfun
💻
rkmdsxmds
💻
devin7788
💻
Cannian
💻
LU XIUYUAN
💻
zzzpppy
💻
Kagaya
💻
Zhang Jinlong
💻
HBUzxl
💻
羊羽
💻
zhubiaook
💻
LOGI
💻
Lorain
💻
lylex
💻
Lin
💻
qcrao
💻
Add your contributions
**翻译进度:**： 79/79 = 100%
## 翻译规范
1. 创建一个认领issue,认领标题中注明tip号和标题。不允许一人同时认领多个任务。翻译完一项任务后才能认领下一个任务。
2. 任务请搜索 Phuong Le 的Twitter账号，找到对应的tip，然后翻译成中文。(可能有的tip作者已经删除，经咨询，作者反馈内容会有增删，所以如果某个tip不存在，请空一个，寻找下一个tip)
3. fork 本项目，然后在 fork 后的项目中进行翻译认领的一个tip,翻译完成后提交pull request
4. 任务请在一周内完成，未完成的任务将被释放，其他人可以认领。
- 项目自动统计贡献者
- 翻译请保持语句通顺，可以使用AI协助翻译，但是一定要避免生硬和机翻的感觉
> **怎么提交Pull Request? **
>
> 如果大家以前没有提交过 Pull Request,可以探索下。
> 首先点击项目右上角的 Fork 按钮，将项目 Fork 到自己的仓库。
> 在github浏览你fork的项目，你会看到一个 "Create pull request" 按钮，点击它
> 填写相关的内容提交即可。
> 后续等待项目的维护者合并你的PR即可。
## 翻译模板
```markdown
# 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 | 使用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 | | |
## 生成文档
如果你想在本地编译， 请安装[mdbook](https://github.com/rust-lang/mdBook)工具。
### 本地预览
在本地`mdbook serve`可以生成本地网站访问。
http://localhost:3000
### 生成静态网站
`mdbook build` 生成网站到`book`目录下。
## 贡献者 ✨