Python 作為世界上最好用的語言，官方支持的文檔一直沒有中文。小伙伴們已經(jīng)習(xí)慣了原汁原味的英文文檔，但如果有官方中文文檔，那么查閱或理解速度都會(huì)大大提升。本文將介紹隱藏在 Python 官網(wǎng)的中文文檔～

• 官方中文文檔地址：https://docs./zh-cn

以前也是有一些第三方維護(hù)的 Python 中文文檔，不過可能因?yàn)槿肆Φ认拗?，并做不到同步更新與維護(hù)。目前也有很多高質(zhì)量的 Python 中文資源，但大部分都是大牛寫的書或教程，官方文檔的翻譯并得不到保證。

最近很多開發(fā)者發(fā)現(xiàn) Python現(xiàn)在已經(jīng)有官方中文文檔了，但直接從 Python 文檔界面并看不到。如下在 Python 文檔中，只有英語、法語、日語和韓語可選，我們并看不到中文選項(xiàng)。

但是如果我們?cè)诘刂窓谥惺謩?dòng)鍵入 zh-cn，即：https://docs./zh-cn，那么我們就能看到官方的中文文檔了。如下，我們現(xiàn)在從下拉項(xiàng)也可以直接看到中文選項(xiàng)。因?yàn)?Python/C API 接口等高階內(nèi)容還是英文，所以很可能目前中文文檔還在完善中，并沒有完全開放。

官方中文文檔有什么

目前，官方中文文檔已經(jīng)有 3.8.0a2、3.7.3、3.6.8、2.7.16 幾個(gè)主流版本的資料，相比英文文檔只缺少 3.5.7。對(duì)于每一個(gè) Python 版本，文檔都包含很多內(nèi)容，其中入門教程與語言參考已經(jīng)完成漢化，其它基礎(chǔ)內(nèi)容也都有中文譯文，例如各版本的新變化、安裝和分發(fā) Python 模塊、常見問題等等。

但是還有一些高階主題基本都保留了英文，例如 Python/C API 接口、標(biāo)準(zhǔn)庫參考、擴(kuò)展和嵌入等。這些內(nèi)容有的比較難懂，也許它們對(duì)譯者的要求更高，完成的進(jìn)度也慢一些。

對(duì)于初學(xué)者而言，入門教程和 Python 語言參考可能是大家最需要的。其中入門教程非正式地介紹了 Python 語言的基本概念和功能。讀者最好在閱讀時(shí)準(zhǔn)備一個(gè) Python 解釋器進(jìn)行練習(xí)，不過所有的例子都是相互獨(dú)立的，所以這個(gè)教程也可以離線閱讀。

Python 語言參考相比入門教程提供了更正式的語法和「核心語義」，這一份參考非常簡(jiǎn)潔，它希望保證知識(shí)點(diǎn)的準(zhǔn)確和完整。除了前面這兩份基本學(xué)習(xí)資料，英文版 Python 文檔還為 C/C++提供了兩個(gè)額外的手冊(cè)，不過這些高階內(nèi)容暫時(shí)還沒有中文。

最后，Python 中文文檔還有個(gè)小彩蛋，它把 Python 中的術(shù)語都翻了一遍。很多時(shí)候，這些術(shù)語都有不同的譯文與表達(dá)方式，例如 decorator 既可以保留原文，也可以翻成裝飾器或修飾器。也許以后，這一份官方詞匯表可以幫助我們找到更合適的表達(dá)方式。

中文文檔怎么搜

可能對(duì)大多數(shù)開發(fā)者而言，檢索 Python 的函數(shù)或用法是文檔的常用方法。例如如果我們希望找到函數(shù)式編程的使用方法，那么可以在中文文檔中搜索 Lambda：

其中流程控制工具有匿名函數(shù) Lambda 的使用簡(jiǎn)介，而重要的函數(shù)式編程指引暫時(shí)只有一小部分完成翻譯。如下展示的是檢索到的 Lambda 使用指南。