快速入门：选择拓扑类型→添加网络设备（路由器、交换机、防火墙）→使用适当的链路类型连接→添加标签和区域→包裹在```drawio fence中。

快速入门：识别图表类型（流程图/序列/状态/类/ER/甘特图/思维导图）→用形状定义节点→用箭头连接→包裹在“美人鱼栅栏”中。默认：从上到下（TD），使用流程图而不是图表，支持 Unicode。

⚠️ 检查模板：错误的模板名称将导致渲染失败。

重要提示：使用 ```dot 作为代码围栏标识符，而不是 ```graphviz 。

快速开始：用墙壁定义房间边界→添加门窗→从模板库中放置家具→添加尺寸和标签→包裹在“绘图栅栏”中。

快速入门：选择图表类型 → 从模板库中添加符号 → 用适当的线条连接 → 添加标签/注释 → 包裹在 ```drawio 围栏中。

快速入门：使用 <diagram> 创建 <mxfile> → 使用网格设置定义 <mxGraphModel> → 添加包含单元格的 <root> → 使用 <mxCell> 作为形状和边缘 → 使用 <mxGeometry> 设置几何图形 → 包裹在 ```drawio fence 中。

快速入门：选择云提供商→从模板库添加服务图标→对区域/VPC中的服务进行分组→使用数据流箭头连接→包裹在```drawio栅栏中。

快速入门：使用 id 、 type 、 x 、 y 、 width 、 height 定义节点 → 在 100px 网格上规划布局 → 使用 fromNode / toNode 连接边缘 → 应用颜色 (1-6) → 包裹在 ```canvas fence 中。原点 (0,0) 位于左上角，X 向右，Y 向下。兼容黑曜石画布。

快速入门：创建具有灵活布局（单/双/三列）的 HTML 结构 → 定义图层和网格的 CSS 样式 → 使用分类面板添加内容 → 对不同图层使用语义颜色。

TypeScript 编译为 JavaScript，输出的质量取决于您的目标配置和编码风格。编写现代 JavaScript (ES2020+) 并让 TypeScript 通过降级处理兼容性。现代功能通常会产生比手动实现回退更干净、更高效的代码。

readonly 表示意图并让 TypeScript 捕获意外突变。

微小的差异通常并不需要单独的类型。

TypeScript 是一种开发工具 - 它在运行时并不存在。同样，@types 包仅包含类型声明，而不包含运行时代码。两者都应安装为 devDependency，而不是依赖项。这可以保持生产构建的精益并防止版本冲突。

类型是一组可能的值。可分配性意味着子集。

对对象类型使用接口，对其他一切使用类型。

TypeScript 中的每个符号都存在于类型空间、值空间或两者中。

您编写的类型不仅适用于编译器，还适用于在 IDE 中阅读代码的开发人员。复杂类型可能会显示为笨拙的扩展，从而模糊含义并损害开发人员的体验。了解如何控制类型显示有助于您创建正确且可读的类型。

类型检查和单元测试可以捕获不同类型的错误。类型检查在编译时捕获类型不匹配。单元测试在运行时捕获逻辑错误和边缘情况。它们相辅相成——类型减少了某些测试的需要，但不能取代逻辑测试。

TSDoc 是记录 TypeScript 代码的标准。它使用 TypeScript 特定的功能（例如泛型类型参数（@template））扩展了 JSDoc。好的文档不仅解释了代码的作用，还解释了原因，并通过 IDE 工具提示和生成的文档帮助用户理解您的 API。