一叶斋
·
编程随笔
内容提要
本文总结了作者在编写 TypeScript 代码时的一些实践，包括：每个条件都应有对应的 else、函数设计要无歧义、避免使用 forEach、警惕深层调用、不要滥用可选参数等，强调代码的清晰性和可维护性。
关键要点
-
每个条件都应有对应的 else，即使什么都不做也要明确说明。
-
函数设计要无歧义，输出应无法反推出输入。
-
避免使用 forEach，推荐使用 for...of 代替。
-
警惕深层调用和引用，避免复杂的依赖关系。
-
不要滥用可选参数，确保函数参数的必要性。
-
让类型在代码中流动，尽量从上下文推测类型。
-
不要提前赋值，避免扩大上下文和阻碍类型收窄。
-
使用 const 而非 let，尽量避免使用 let。
-
对外输出的函数应显式声明返回值类型。
-
在处理边界情况前，考虑是否能通过普适逻辑处理。
延伸解读
条件语句的设计原则
在编写条件语句时，确保每个 if 语句都有对应的 else，可以提高代码的可读性和可维护性。即使在 else 中什么都不做，也要明确说明，这样可以帮助开发者更好地理解代码的逻辑结构，避免潜在的错误。
函数设计的无歧义性
设计函数时，确保输出无法反推出输入是关键。这样可以避免因输入输出不一致而导致的混淆，增强代码的可靠性。开发者应当关注函数的参数和返回值，尽量减少冗余信息，以提高代码的清晰度。
避免深层调用和复杂依赖
在项目中，深层调用和复杂的模块依赖会增加代码的维护难度。开发者应当警惕这种情况，尽量简化调用层级，确保代码结构清晰，便于理解和修改。
可选参数的合理使用
在 TypeScript 中，滥用可选参数可能导致代码的复杂性和潜在的错误。开发者应当明确哪些参数是必需的，避免在函数中增加过多的容错逻辑，以提升代码的可读性和执行效率。
延伸问答
为什么每个条件都应该有对应的 else？
每个条件都有对应的 else 可以明确说明在不满足条件时的处理方式，即使什么都不做也要表明，这样有助于代码的可读性和追溯性。
如何设计无歧义的函数？
无歧义的函数应确保输出无法反推出输入，避免冗余信息，以减少潜在的混淆和错误。
为什么要避免使用 forEach？
forEach 使用回调函数遍历数组，可能导致类型推断不明确，推荐使用 for...of 以提高代码的可读性和安全性。
可选参数的滥用有什么风险？
滥用可选参数会导致函数内部出现冗余的容错逻辑，增加代码复杂性，且可能导致死代码的产生。
如何让类型在代码中流动？
让类型流动的方式是尽量从上下文推测类型，而不是主动导入类型，这样可以降低模块间的依赖关系。
提前赋值有什么潜在问题？
提前赋值会扩大上下文，可能导致不必要的变量引入，阻碍类型收窄，增加代码的复杂性。
