停止使用 .d.ts 文件—如果你想讓你的應用變慢 | 高級 TypeScript
TypeScript 自推出以來已經走了很長一段路，現已成為為 JavaScript 添加類型安全的首選工具。
無論你是經驗豐富的 TypeScript 老手，還是剛剛入門的初學者，你可能都遇到過 .d.ts 文件——這些神秘的類型聲明文件似乎有自己獨立的世界。
在這篇文章中，我們將深入探討為什么在 2024 年我們需要使用 .d.ts 文件，它們如何融入我們的開發流程，以及什么時候你可能更愿意堅持使用一般的 .ts 文件。
為什么在 2024 年需要使用 .d.ts 文件
從高層次上看，.d.ts 文件是 TypeScript 聲明文件。它們包含類型聲明（接口、類型、類等），但不包含任何實現代碼。
可以將它們看作是定義代碼結構的藍圖，但并不實際構建任何東西。
這些文件允許 TypeScript 理解你的模塊、類和函數的形狀，而無需了解它們的底層邏輯。
什么是 .d.ts 文件？
那么，為什么在 .ts 文件中已經可以直接定義類型和接口時，我們還需要這些 .d.ts 文件呢？
答案在于 TypeScript 如何與 JavaScript 生態系統和外部庫進行接口設計。
.d.ts 文件的作用
- 關注點分離使用 .d.ts 文件的一個關鍵原因是保持類型定義和實現代碼之間的清晰分離。這在處理大型代碼庫或開發供他人使用的庫時尤為有用。通過將類型隔離在 .d.ts 文件中，你可以保持實現的清晰和專注，同時讓他人更容易理解你的模塊的 API 表面。
示例：
通過 .d.ts 文件，干凈地將契約與實現分開。
- 庫開發如果你正在開發一個供其他 TypeScript 或 JavaScript 項目使用的庫，.d.ts 文件是不可或缺的。它們允許你公開一個定義良好的 API，而不會泄露實現細節。當他人安裝你的庫時，得益于這些聲明文件，他們可以在使用時獲得完整的 IntelliSense 支持和類型安全。
在發布庫時，將 .d.ts 文件包含在你的包中，可以讓使用者獲得類型信息，而無需轉譯你的代碼或深入研究實現。 - 第三方庫集成通常，我們會使用并非用 TypeScript 編寫的 JavaScript 庫。為了利用 TypeScript 的類型檢查，我們需要描述這些庫提供的對象和函數的形狀。這時 .d.ts 文件就派上了用場。許多流行的庫，如 jQuery 或 Lodash，都有在 DefinitelyTyped 倉庫中維護的社區版本的 .d.ts 文件，可以通過 npm 安裝。
示例：
一旦安裝，TypeScript 即可對 Lodash 的使用進行類型檢查，盡管 Lodash 本身不是用 TypeScript 編寫的。
- 大型項目中的性能提升在大型項目中，將類型定義放在 .d.ts 文件中可以幫助提高性能。TypeScript 的編譯器可以比普通 .ts 文件更快地分析這些文件，因為 .d.ts 文件不包含實際的實現代碼。它們只描述類型，從而簡化了編譯過程。
何時使用 .d.ts 文件而不是普通 .ts 文件
盡管 .d.ts 文件非常有用，但它們并不總是最佳選擇。
有時，將類型和接口直接存儲在 .ts 文件中更為合理，尤其是在你正在處理一個內部項目時，分離實現和類型并不那么重要。
在以下情況下使用 .d.ts 文件：
- 開發庫：如前所述，如果你的代碼將被他人使用，使用 .d.ts 文件來公開一個干凈的 API 是最佳實踐。
- 與 JavaScript 庫進行接口對接：當你需要描述第三方 JavaScript 庫提供的類型時。
- 隔離類型定義：如果你希望通過將類型與實現分離來保持項目的組織，尤其是在大型項目中或類型在許多模塊中復用時。
在以下情況下堅持使用 .ts 文件：
- 內部項目：如果你的項目是內部使用的，并且不需要單獨公開類型，保持所有內容在 .ts 文件中可能更簡單。
- 小型項目：在小型項目中，維護單獨的 .d.ts 文件的開銷可能不值得。
- 快速原型開發：當你在項目中快速迭代時，將類型與實現放在同一文件中可以避免上下文切換，從而更快。
2024 年使用 .d.ts 文件的最佳實踐 ??
- 利用 TypeScript 的 declare 關鍵字在編寫 .d.ts 文件時，記住你不需要使用export關鍵字，除非你在處理模塊。相反，使用declare表示類型和接口是全局可用的。
示例：
declare interface MyInterface {
name: string;
age: number;
}- 保持 .d.ts 文件的簡潔.d.ts 文件的美妙之處在于其簡潔性。它們只應包含類型聲明——別無其他。避免在這些文件中包含邏輯或初始化代碼的誘惑。
- 謹慎使用 /// <reference /> 指令雖然可以使用 /// <reference /> 指令鏈接 .d.ts 文件，但盡量避免，除非絕對必要。相反，依賴 TypeScript 的模塊解析來管理類型文件之間的依賴關系。
- 邏輯地組織類型聲明按照與你項目架構相匹配的方式組織 .d.ts 文件。例如，將全局類型放在一個 globals.d.ts 文件中，將模塊特定的類型放在各自模塊目錄中的 .d.ts 文件中。
結論
在 2024 年，.d.ts 文件依然是 TypeScript 開發者工具箱中的強大工具。
它們為大型項目帶來了清晰性、組織性和性能優勢，在構建 JavaScript 和 TypeScript 生態系統中的庫時更是不可或缺。
然而，像所有工具一樣，應該謹慎且恰當地使用它們。通過理解何時以及如何使用 .d.ts 文件，你可以編寫更清晰、可維護性更強的代碼，并為自己和他人創造更好的開發體驗。
所以，下次你在設計一個 TypeScript 項目時，不妨考慮一下 .d.ts 文件是否應該出現在你的代碼庫中。它們很可能會讓你的生活——以及代碼——變得更好。
