新發布的 TypeScript 手冊！先睹爲快！

原文地址：Announcing the New TypeScript Handbook

原文做者：Orta Therox

譯文出自：掘金翻譯計劃

本文永久連接：github.com/xitu/gold-m…

譯者：zenblo

校對者：itcodes、PassionPenguin

嘿！開發者們，咱們很高興地向你們宣佈，一個徹底重寫的 TypeScript 手冊如今已經轉入正式版了，而且將會成爲咱們網站學習 TypeScript 的主要資源！html

經過 Web、Epub 或 PDF 閱讀新發布的 TypeScript 手冊。前端

在過去的一年裏，團隊高度重視提高 TypeScript 文檔的規模、時效性和範圍。TypeScript 手冊是咱們的文檔中最關鍵的部分，它是你在大多數代碼庫中都會看到的 TypeScript 代碼的導覽。咱們但願這本手冊能讓你以爲是學習 TypeScript 的首選資料。android

去年新版網站的發佈中，咱們已經將一些漸進式的改進歸入到手冊中，同時新版手冊爲新網站的不少功能提供了指引。ios

而在這個從 2018 年啓動的新 TypeScript 手冊項目中，咱們編寫手冊的方式增長了一套規範。git

將 JavaScript 的教學工做交給專家去作

經過網絡和書籍學習 JavaScript 的資源很是多。咱們沒有必要在這個領域競爭。這本手冊旨在幫助開發者理解 TypeScript 構建在 JavaScript 上的方式。這個重點意味着咱們的文檔能夠對背景進行假設，避免從頭開始解釋 JavaScript 的特性。github

咱們但願不一樣技術水平的開發者都能使用這本手冊。例如，咱們在網站上添加了一個新功能，讓人們根據本身的技術背景，初步瞭解 TypeScript 與其餘語言的區別，做爲閱讀手冊以前的準備。你能夠在文檔概述中看到。web

按部就班的教學

咱們但願以一種按部就班的方式來學習 TypeScript 的概念 —— 避免使用還沒有解釋的 TypeScript 特性。這種約束很好地使咱們從新思考語言概念的順序和類別。這種教學方式讓前幾頁的手冊編寫變得有點困難，但對開發者來講確實變得頗有價值，並支持從頭至尾的閱覽風格。typescript

讓編譯器說了算

若是你已經使用了網站上新發布的 TypeScript 文檔，那麼你應該已經注意到咱們提供了一些代碼示例，這些示例提供了內聯的上下文，例如快速信息提示和錯誤提示，甚至還能夠顯示 output.js 和 .d.ts 文件。npm

做爲手冊的編寫者，咱們必須處理好 TypeScript 的變化對文檔的影響。當咱們把網站遷移到一個新的 TypeScript 版本時，也會遷移手冊。若是結果不一致，咱們很容易發現，並決定須要作哪些改變。後端

使人興奮的是，咱們正在使用這些工具，將編輯經驗中的一些最好的功能帶入 Web 頁面，並以 epub 或 pdf 格式靜態地展現手冊。這項技術也能夠爲你的應用程序提供幫助。

對開發者來講，這意味着網站中全部的代碼示例都是最新的、準確的和交互式的！

針對平常案例進行編寫

TypeScript 已經有 8 年的歷史了，整體來講，並無刪除功能。咱們在參考頁部分記錄全部可能的用途，以及任何概念的可行選擇。咱們認爲這應該能夠減小在 TypeScript 啓蒙道路上的干擾。

對咱們中的一些人來講，瞭解 JavaScript 捆綁模式的歷史或者更深奧的 TypeScript 選項如何改變代碼流分析可能會頗有趣（對我來講就是這樣！），但大多數人要麼是爲了 greenfield 項目而學習，要麼是在代碼庫中工做時已經瞭解了全部這些。

這些規範爲咱們提供了一個更有針對性的且更容易學習的 TypeScript 語言指引。咱們會一直是 TypeScript 的忠實粉絲（即便咱們可能更偏心 TypeScript）。

雖說是由我來發布 TypeScript 新手冊，並把它推送到網站上的，但在 TypeScript 團隊中，新手冊業已經是一個持續多年的項目，有了不少的貢獻了。在過去的幾個月裏，咱們得到了你們的好評，這也有助於給咱們如何解釋想法提供一些新的視角。因此在這裏，我想對每個參與的人說聲謝謝!

若是你一直在經過這個博客中的季度性發布說明了解 TypeScript 的最新狀況，那你極可能會從新閱讀一遍咱們的手冊！咱們在其中展現了全部的功能，不管新舊，相互關聯，有序介紹。但願你不會錯過那些精彩內容！另外若是你發現了咱們遺漏的內容，請隨時在 TypeScript 倉庫中提出 Issue 告訴咱們一聲。

快來在咱們的官網上或經過下載最新的 Epub、PDF 文件來閱讀咱們最新發布的 TypeScript 手冊吧！。

若是發現譯文存在錯誤或其餘須要改進的地方，歡迎到掘金翻譯計劃對譯文進行修改並 PR，也可得到相應獎勵積分。文章開頭的 本文永久連接 即爲本文在 GitHub 上的 MarkDown 連接。

掘金翻譯計劃是一個翻譯優質互聯網技術文章的社區，文章來源爲掘金上的英文分享文章。內容覆蓋 Android、iOS、前端、後端、區塊鏈、產品、設計、人工智能等領域，想要查看更多優質譯文請持續關注掘金翻譯計劃、官方微博、知乎專欄。