TypeScript 规范涵盖了语言特性的正确使用方式，包括普通类型、泛型、回调函数类型和函数重载。以下将详细介绍每个方面，并提供正常用例和错误用例，帮助理解 TypeScript 规范的实际应用。
1. 普通类型
正常用例
普通类型指的是 TypeScript 中的基本数据类型和自定义类型。这些类型可以用来声明变量、函数参数、返回值等。
示例：
// 声明变量和函数参数类型
let name: string = "Alice";
let age: number = 30;
function greet(person: string): void {
console.log(`Hello, ${person}!`);
}
greet(name); // 正确使用
错误用例
错误的使用方式包括将变量赋予不匹配的类型或者在函数调用时传递不符合类型预期的参数。
示例：
// 错误的类型赋值
let name: string = 42; // 类型不匹配
// 错误的函数调用
greet(42); // 参数类型不匹配
2. 泛型
泛型允许在定义函数、类或接口时延迟指定类型，提高代码的复用性和灵活性。
正常用例
使用泛型可以在定义函数或类时不指定具体类型，而是在使用时根据传入的参数类型来确定。
示例：
// 泛型函数
function identity<T>(arg: T): T {
return arg;
}
let output = identity<string>("hello"); // 使用泛型并指定类型
console.log(output);
let output2 = identity(42); // 类型推断，自动识别为 number 类型
console.log(output2);
错误用例
在泛型使用中的错误通常涉及类型不匹配或不正确的用法。
示例：
// 错误的泛型使用
function identity<T>(arg: T): T {
return arg.length; // T 类型没有 length 属性
}
let result = identity<number>(42); // 类型不匹配，number 类型没有 length 属性
console.log(result);
3. 回调函数类型
回调函数类型是指在 TypeScript 中定义函数参数时指定函数的类型。
正常用例
使用回调函数类型可以确保函数接受正确类型的函数作为参数。
示例：
// 回调函数类型
function fetchData(callback: (data: string) => void): void {
// 模拟异步操作
setTimeout(() => {
const data = "Data fetched successfully";
callback(data);
}, 1000);
}
function processData(data: string): void {
console.log(`Processing data: ${data}`);
}
fetchData(processData); // 正确传递回调函数
错误用例
错误的回调函数类型使用可能导致参数类型不匹配或函数调用失败。
示例：
// 错误的回调函数类型使用
function fetchData(callback: (data: number) => void): void {
// 模拟异步操作
setTimeout(() => {
const data = "Data fetched successfully";
callback(data); // 参数类型不匹配
}, 1000);
}
function processData(data: string): void {
console.log(`Processing data: ${data}`);
}
fetchData(processData); // 参数类型不匹配，应传递 (data: string) => void 类型的函数
4. 函数重载
函数重载允许定义多个函数签名来处理不同的参数类型或数量，提高函数的灵活性和适用性。
正常用例
通过合理定义函数重载，可以根据不同的参数类型或数量调用不同的函数实现。
示例：
// 函数重载
function format(input: string): string;
function format(input: number): string;
function format(input: any): string {
if (typeof input === "string") {
return input.toUpperCase();
} else if (typeof input === "number") {
return input.toFixed(2);
}
return "";
}
let result1 = format("hello"); // 调用第一个重载
console.log(result1);
let result2 = format(42); // 调用第二个重载
console.log(result2);
错误用例
错误的函数重载定义或调用可能导致函数无法正确识别参数类型。
示例：
// 错误的函数重载使用
function format(input: string): string;
function format(input: number): string;
function format(input: any): string {
return input.length; // 无法处理非字符串和数字类型
}
let result = format(true); // 类型不匹配，无法调用
console.log(result);
总结
遵循 TypeScript 规范，正确使用普通类型、泛型、回调函数类型和函数重载是确保代码类型安全性和可维护性的重要步骤。通过合理的类型定义和使用，可以有效减少运行时错误，并提升代码的可读性和可靠性。