[譯]參考資料: 地道的GO代碼

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

目錄 [−]

1. Accept interfaces, return concrete types
2. Code Review Comments
3. Effective Go
4. Go Patterns
5. Go Proverbs
6. Go and the Zen of Python
7. Go by Example
8. Idiomatic Doc Comments: Document Your Function, Not Your Function Signature
9. Idiomatic Go
10. Idiomatic Go Readability
11. Idiomatic Go Tests
12. Idiomatic Go Trickshttps://medium.com/@matryer/idiomatic-go-tricks-62abea5c50fb
13. Itty Bitty Go Idiom: If Without Else
14. Things I learned teaching Go
15. What is idiomatic Go?
16. When in Go, do as Gophers do
17. 50 Shades of Go: Traps, Gotchas, and Common Mistakes for New Golang Devs

原文: Idiomatic Go

什麼樣的代碼才算最地道的Go代碼？ 這個問題經常被人問起，但是確不太好回答。部分原因在於我們還在摸索之中，抑或Go還是一個年輕的語言。隨著語言和社區的逐漸成熟，老司機們才會對地道的Go代碼達成共識。

請注意，地道的代碼不是限制你的規則，而是代碼指導。工作正常的代碼比地道的代碼更重要。因為所謂的地道,只是大家達成的一種共識，所以"不地道"的的代碼不一定代表著錯誤。

既然沒有確定的答案，我在本文中收集了相關的參考資料, 以饗讀者。

Accept interfaces, return concrete types

Craig Brookes 2016-11-02

解釋什麼是地道的代碼， 為什麼你要遵循它。

Code Review Comments

在Code review的時候一套通用的指導， 簡短几句話介紹編寫代碼的地道的方式。 Go官方出品。

Effective Go

Go開發組提供了編寫清晰、地道的Go代碼的小竅門。這是Go程式員必讀的參考文檔， 不止有地道的代碼指導，而且還有Go各種特性的背後的考量。

Go Patterns

Tamer Tas

關於Go語言的設計模式和應用程式模式的集合。

Go Proverbs

Rob Pike收集的簡單、富有詩意的精闢語錄， 解釋Go語言深層次的哲學、以更容易理解方式。真正理解並應用它們會讓你成為Go大牛。

Go and the Zen of Python

Andrew Gerrand

比較 Python 和 Go 之禪意。

Go by Example

使用帶註解的例子教授Go， 會討論什麼樣的代碼才是地道的代碼。

Idiomatic Doc Comments: Document Your Function, Not Your Function Signature

Katrina Owen 2015-10-14

通過樣本解釋如何為Go函數編寫有協助的注釋。

Idiomatic Go

Dmitri Shuralyov

對Code Review Comments的補充，通過令人信服理由和參考文獻， 列舉了地道的Go代碼指導。

Idiomatic Go Readability

haya14busa

地道的可讀性的Go代碼的實踐經驗和竅門， 包括自動和手動方式。

Idiomatic Go Tests

Craig Brookes

作者通過例子解釋地道的Go測試應該怎麼做。

Idiomatic Go Trickshttps://medium.com/@matryer/idiomatic-go-tricks-62abea5c50fb

Mat Ryer video slides 2016-08-18

一些技巧和竅門讓你像個老司機一樣談論Go。

Itty Bitty Go Idiom: If Without Else

Katrina Owen 2015-10-16

為什麼你通常看到的Go代碼中if語句沒有else分支， 這篇文章解釋了這個問題。

Things I learned teaching Go

Francesc Campoy Flores 2014-10-10

It's better because it's what other people in the community expect.

通過教學總結的經驗。

What is idiomatic Go?

這是reddit是的一篇討論，對一個程式碼程式庫的中的非地道Go代碼的抨擊。評論顯示這些地道代碼指導對社區的協助和傷害。

When in Go, do as Gophers do

Fumitoshi Ukai 2014-11-30

通過Review對Go項目代碼的提交學到的一些地道的編寫Go代碼的方式。作者作為 Go Readability Approver,一年中review大約200左右的 CL， 在本文中總結了他所學到的。

一旦我發現了更多的參考資料，我會更新這篇文章， 所以記得收藏本文。

當然作為譯者，我也會補充更多的參考資料，如果你發現了一些關於這方面的參考資料，記得在評論中貼出來哦。

50 Shades of Go: Traps, Gotchas, and Common Mistakes for New Golang Devs

Kyle Quest

Go的50度灰：Golang新開發人員要注意的陷阱和常見錯誤