2、TypeScript基础：代码规范与语言关系解析

TypeScript基础：代码规范与语言关系解析

1. TypeScript代码示例的约定

1.1 代码语言与错误表示

在大多数代码示例中，除非上下文明确表明是JSON、HTML或其他语言，否则均为TypeScript代码。当需要在代码示例中表示错误时，通常会在错误发生位置的下一行注释中使用波浪线（~）来标注，并给出错误信息。例如：

let str = 'not a number';
let num: number = str;
//  ~~~ Type 'string' is not assignable to type 'number'

这里需要注意的是，为了清晰和简洁，可能会对错误信息进行编辑，但不会移除错误本身。如果将代码示例复制到编辑器中，应该会得到与标注一致的错误。

1.2 无错误提示与类型显示

为了强调代码没有错误，会使用 // OK 进行标注。例如：

let str = 'not a number';
let num: number = str as any;  // OK

同时，为了在文本中表示某个符号的类型，可以使用带有Twoslash语法（^?）的注释。例如：

let v = {str: 'hello', num: 42};
//  ^? let v: { st