google_eng_practice

Google工程實踐文檔

Google有很多優秀的工程實踐，這些實踐遍布公司內的所有項目，覆蓋了幾乎所有編程語言。 隨著開發項目的增多，我們不斷總結經驗，把這些最佳實踐以文檔的形式整理出來。現在文檔日趨成熟，我們決定將其公開發布，讓其他公司、組織或開源項目也能從中受益。

這份工程實踐文檔內容如下：

• Google代碼審核指南，它包含兩部分：
  • 代碼審核者指南
  • 代碼提交者指南

術語

在文檔中，用到了一些Google 內部術語，為避免誤解，我們稍作解釋：

• CL ： 即“changelist”， 中文可以翻譯成修改列表，它是提交到版本控制工具中的一次代碼修改（即將審核的代碼）。有的公司或組織稱它為“改變”(change)或“補丁”(patch)。
• LGTM ： “Looks Good to Me.” 的縮寫，“看起來不錯”。 當一個審核者這麼說的時候，意味著他會批准這個CL。
• g3doc ： Google內部的工程文檔平台。

版本

英文原文來自Google's Engineering Practices documentation，中文版由zijinshi 翻譯整理。根據中文表達習慣，在原文基礎上有少量修改。

版本	日期	說明
1.0	2019.10.07	初版完成
1.1	2019.10.18	修復某些翻譯不准確的地方
1.2	2020.01.02	修改語句不通順、翻譯用詞不一致的地方
1.3	2024.04.26	基於英文版的最新內容，更新中文版

中文版同時發佈於網站：

• Google工程實踐文檔(Github)
• Google工程實踐文檔(Gitbook)

視頻學習：

• Google工程實踐文檔導讀

PDF版本下載：

• Google工程實踐文檔

Google代碼實踐的一些感悟

License

本文遵守CC-By 3.0 License（中文版、英文版）。

The documents in this project are licensed under the CC-By 3.0 License, which encourages you to share these documents. See https://creativecommons.org/licenses/by/3.0/ for more details.