全栈术语笔记

什么是 API

简而言之，API 是 一个软件组件与另一个软件组件之间通信的“接口/约定” ，定义了怎样请求服务、怎样响应、可用的数据格式、参数、权限等。

ABI 和 API 的区别

这是一个常见的困惑点：

• API（应用程序编程接口） ：是高级的抽象，定义了你可以调用什么（哪些函数），但它隐藏了如何调用的底层细节。比如，你调用 api.getUser(123)。
• ABI（应用程序二进制接口） ：是低级的规范，它正确定义了如何调用的底层细节。比如，如何将 getUser 这个函数名和参数 123 编码成一行二进制码，让机器执行。

简单说：API 是给人用的接口，ABI 是给机器用的接口。

SDK（Software Development Kit，软件开发工具包）就是一套“给开发者用的工具 + 代码”的集合，通常面向某个特定平台/系统，帮你更快地把应用或集成做出来。它常常把编译器/调试器、运行时、命令行工具、类库/API、示例代码与文档打包在一起。

TypeScript基本定义

• TypeScript（简称 TS）是微软在 2012 年推出的一门开源编程语言。

• 它是 JavaScript 的一个语法超集（syntactic superset），也就是说你写的纯 JavaScript 在 TypeScript 中几乎都是合法的。

• TypeScript 加入了“静态类型”（static typing）这个特性，也允许类型注解（type annotations）。这些在编译（或者说类型检查）阶段就会被检查，而不是等到运行时才发现错误。

TypeScript SDK 是做什么的（用在哪些情境）

常见场景包括：

• 云服务：比如 AWS、Azure、Google Cloud 等，提供 TypeScript SDK，让你在 Node.js 或 Web 前端项目中方便地调用他们的服务。
• 区块链 / 区块网络 /DeFi 平台：提供 RPC 调用的 SDK，用 TS 写，封装合约调用、交易签名、网络连接等。
• API 平台 /第三方服务：比如聊天机器人 API、分析 SDK、支付 SDK、存储 SDK 等。
• 监控 /日志 /追踪：SDK 用来把应用中的日志/指标发送给监控系统，用 TypeScript 实现能兼容前端或后端 JS 环境。

Vercel定义

Vercel 是一个现代 Web 部署与托管平台（Cloud Platform / PaaS / Edge + Serverless 结合体），面向前端 /全栈 /静态 + 动态网页应用。

什么是 Dashboard

• Dashboard 是一种图形用户界面（GUI），用于“一眼看出”某个系统／业务／项目的重要状态。它把多个相关但不同的数据点／指标（metrics）汇聚起来，通过图表、图形、表格等形式显示在同一个界面上。
• 数据一般是来自多种来源（数据库、日志、API 等），并且经常是动态更新或定期更新的。
• Dashboard 的重点是“可视化 + 快速判断”，目的是帮助用户快速获取整体情况、发现异常、判断趋势，以便做决策。

SVG 是什么

• SVG 是一种基于 XML 的图形文件格式，用来描述二维图形（线条、形状、路径、文本等
• 因为是矢量图（vector graphics），SVG 图像可以任意缩放（放大或缩小）而不会失真或模糊
• SVG 是开放标准，由 W3C（万维网联盟）维护

XML 是什么

• XML 是一种“标记语言”（markup language），类似 HTML，但用途不同。标准由 W3C（万维网联盟）制订。
• “Extensible” 意味着 可扩展：你可以自己定义标签（tags）来描述你的数据结构，而不是像 HTML 那样标签是固定的一套。
• XML 文档同时对人类可读、机器可读；也就是说它既能用文本编辑器查看，也能由程序解析读取数据结构。

“Vercel 和 v0 是什么关系”，你可以这样说：

“Vercel 是一个 Web 应用部署与托管平台，它负责把静态或动态 Web 应用上线／托管／加速等；而 v0 是 Vercel 推出的一个 AI 辅助工具，用于加速应用或 UI 的构建，比如你可以通过自然语言指令生成页面／组件／项目结构，然后把这些生成内容部署到 Vercel 上。v0 属于 Vercel 的产品线，是其生态中提升开发体验／加速零到一原型／界面设计的一环。”

React 是一个用于构建用户界面的 JavaScript 库（Library），而 Next.js 是一个基于 React 构建的全栈 Web 应用框架（Framework）。

URL（统一资源定位符）就是我们在互联网上访问任何资源时，在浏览器地址栏里输入的那一串“地址”。  它的唯一作用是告诉浏览器如何在浩瀚的互联网上找到并获取特定的资源。

特点	CSV 优点	JSON 优点
简单性	非常简单，文本 + 逗号 + 换行。打开／编辑都很容易。	可以支持复杂结构（例如一个字段里有数组或对象）。
可读性 /工具支持	Excel、表格软件、数据分析工具几乎都支持。	支持编程语言直接解析、灵活性强。
文件大小	对于“纯表格数据”（每条记录字段一致）非常紧凑，占空间少。	因为字段名要重复，对象嵌套等，文件通常比同样数据的 CSV 大一些。
表结构灵活性	不太适合有嵌套或者不规则字段的情况。每条记录通常字段一一对应。	可以有嵌套结构，可以有可选字段，不同记录字段数目不一定完全一致。
程序处理方便性	脚本 / 数据分析 /表格里处理简单。	在应用中／Web API 中／需要树形结构或对象的时候很方便。

package.json 是 Node.js / JavaScript 项目的一个非常重要的文件，用来管理你的项目元数据、依赖关系、脚本等。如果你用 npm / pnpm / yarn 等包管理工具做开发，它几乎是必备的。