TypeScript 快速实战系列：基础入门｜TypeScript 核心语法 1 小时吃透（必备基础）

导读上一篇我们搞定了TS环境搭建也搞懂了为什么大模型开发必须学TS。今天这篇不搞复杂理论只讲大模型开发中「最常用、最核心」的TS语法——基础类型类型注解1小时就能吃透学完就能给大模型API参数、返回值做类型定义彻底告别“参数传错”的坑适合人群零基础、前端/AI开发新手全程实战每一行代码都能直接复制运行结合大模型场景讲解不学没用的语法。一、先搞懂TS与JS的核心区别一句话说透很多人分不清TS和JS的关系其实很简单TypeScript JavaScript 类型系统也就是说所有JS代码都是合法的TS代码但TS多了“类型约束”——你可以给变量、函数参数、返回值定义“类型”告诉TS这个值应该是什么样子写错了就会直接报错。举个大模型开发中的例子// JS代码没有类型约束传错类型也不报错运行时才崩const temperature 0.7; // 应该是数字却传了字符串// TS代码有类型约束传错类型直接报错写代码时就提醒const temperature: number 0.7; // 报错类型“string”不能赋值给类型“number”这就是TS的核心价值——提前规避错误尤其在大模型API调用中参数类型繁多有了类型约束能少踩很多坑。二、大模型开发最常用的5种基础类型必记TS的基础类型有很多但大模型开发中常用的只有5种记住它们就能搞定80%的基础场景不用记所有类型1. 字符串类型string用途大模型API密钥apiKey、模型名称model、对话内容content、请求地址url等都是字符串类型。// 语法变量名: 类型 值const apiKey: string sk-xxxxxxxxxxxxxxxx; // 大模型API密钥const model: string qwen-max; // 通义千问模型名称const userContent: string 用TS写一个大模型调用函数; // 用户对话内容2. 数字类型number用途大模型的temperature温度0~2、max_tokens最大生成 tokens 数、top_p等参数都是数字类型。const temperature: number 0.7; // 控制生成内容的随机性const maxTokens: number 1000; // 最大生成 tokens 数const topP: number 0.9; // 控制生成内容的多样性3. 布尔类型boolean用途大模型的stream流式输出true/false、是否开启调试模式等都是布尔类型。const stream: boolean true; // 开启流式输出打字机效果const debug: boolean false; // 关闭调试模式4. 任意类型any用途临时不确定类型的值比如大模型返回的复杂数据暂时不知道结构但尽量少用——用多了就失去了TS的类型约束意义是大模型开发中最容易踩的坑。// 临时使用尽量避免let llmResponse: any {}; // 暂时不知道返回结构先用any⚠️ 避坑提醒如果长期用any定义大模型返回值就等于放弃了TS的智能提示和类型校验和用JS没区别后续会踩更多坑。5. 未知类型unknown用途替代any的“安全版本”当你不确定类型时用unknown比any更安全——unknown类型的值不能直接使用必须先判断类型才能操作。let llmResponse: unknown hello world;// 不能直接使用必须先判断类型if (typeof llmResponse string) {console.log(llmResponse.length); // 此时确定是string类型才能调用length}大模型开发中接收API返回值时用unknown比any更安全避免误操作。三、核心语法类型注解大模型开发必用类型注解就是“给变量、函数参数、返回值贴标签”告诉TS它们的类型语法非常简单标识符: 类型。下面结合大模型开发场景讲解3种最常用的类型注解学完就能直接用。1. 变量的类型注解最基础就是给变量定义类型前面讲基础类型时已经用过了再汇总一个大模型场景的示例// 大模型请求相关变量的类型注解 const apiKey: string sk-xxxxxxx; const model: string gpt-3.5-turbo; const temperature: number 0.7; const stream: boolean true; const baseUrl: string https://api.openai.com/v1/chat/completions;这样定义后只要给这些变量赋值错误的类型TS就会直接报错提前规避问题。2. 函数参数的类型注解大模型开发中我们会写很多调用API的函数给函数参数加类型注解能避免传错参数类型。// 示例定义一个大模型请求参数的函数 function getLlmParams( model: string, // 模型名称字符串类型 temperature: number, // 温度数字类型 stream: boolean // 流式输出布尔类型 ) { return { model, temperature, stream, messages: [], // 后续会讲暂时空数组 }; } // 正确调用参数类型匹配 getLlmParams(qwen-max, 0.7, true); // 错误调用temperature传了字符串直接报错 getLlmParams(qwen-max, 0.7, true); // 报错类型“string”不能赋值给类型“number”3. 函数返回值的类型注解给函数返回值加类型注解能明确函数返回的是什么类型方便后续使用也能避免函数返回错误的值。// 定义函数返回值类型对象类型后续会详细讲这里先了解 function getLlmParams( model: string, temperature: number, stream: boolean ): { model: string; temperature: number; stream: boolean; messages: [] } { return { model, temperature, stream, messages: [], }; } // 调用函数能明确知道返回的结构和类型 const params getLlmParams(qwen-max, 0.7, true); console.log(params.model); // 智能提示model是string类型四、实战小任务定义一个「大模型请求配置」类型变量学完上面的内容我们来做一个实战小任务直接贴合大模型开发场景巩固今天的知识点——定义一个完整的大模型请求配置变量包含所有常用参数。// 实战定义大模型请求配置 const llmConfig: { apiKey: string; model: string; temperature: number; stream: boolean; maxTokens: number; baseUrl: string; } { apiKey: sk-xxxxxxxxxxxxxxxx, model: gpt-3.5-turbo, temperature: 0.7, stream: true, maxTokens: 1000, baseUrl: https://api.openai.com/v1/chat/completions, }; // 打印配置验证是否正确 console.log(大模型请求配置, llmConfig);将这段代码复制到index.ts文件中用ts-node index.ts运行能正常打印配置就说明你掌握了今天的知识点五、避坑指南大模型开发中TS最容易踩的坑滥用any类型这是最常见的坑很多人觉得any方便什么都用any结果失去了TS的类型约束和用JS没区别忽略类型报错写代码时TS提示类型错误觉得“能运行就行”强行忽略后续会出现各种诡异的bug给变量赋值错误类型比如把大模型的temperature赋值为字符串虽然JS能运行但TS会报错一定要按照定义的类型赋值。六、本篇总结下一篇预告✅ 核心收获掌握了大模型开发最常用的5种基础类型学会了变量、函数参数、返回值的类型注解能独立定义大模型请求配置变量❌ 避坑提醒少用any类型重视TS的类型报错养成“先定义类型再写代码”的习惯 下一篇预告《核心进阶Interface Type大模型开发神器》带你学会用Interface和Type定义复杂的大模型请求/返回类型彻底解决“返回值字段找不到”的问题直接搞定80%的LLM开发TS需求 评论区互动今天的语法你学会了吗试着自己写一个大模型请求配置变量留言贴出你的代码一起交流进步