首页/新闻资讯/正文详情

Vue3流式调用大模型接口完整实践

发布时间:2026/11/21 6:55:33 来源:云帆数科 栏目:资讯中心
Vue3流式调用大模型接口完整实践
现在主流大模型 API 都支持SSE 流式输出能实现打字机实时返回回答效果体验远优于一次性等待完整结果返回。本文基于 Vue3script setup组合式 API使用原生FetchReadableStream不依赖第三方库完整实现 DeepSeek 接口普通返回 / 流式切换双模式附带逐行代码拆解与底层原理讲解。一、整体实现效果输入提问文本点击提交请求大模型勾选 Streaming 开启流式打字机输出取消则一次性返回完整回答请求过程显示「思考中...」加载状态纯原生 JS 实现流解析无 axios、sse.js 等额外依赖完整封装接口请求、二进制流解码、分段文本拼接逻辑二、分段代码详细解析3.1 响应式数据定义const question ref(讲一个中国龙的故事); const content ref(); const stream ref(true);refVue3 基础响应式 API处理字符串、数字等基础类型底层为RefImpl实例通过.value读写原始值question双向绑定输入框存储用户提问contentAI 回答渲染容器流式模式下持续追加文本stream布尔开关控制接口stream参数切换两种返回模式3.2 基础请求封装const endpoint https://api.deepseek.com/chat/completions; const headers { Content-Type: application/json, Authorization: Bearer ${import.meta.env.VITE_DEEPSEEK_API_KEY}, };DeepSeek 官方对话接口地址鉴权使用 Bearer Tokenimport.meta.env.VITE_XXXVite 环境变量将 API 密钥存入.env文件避免硬编码泄露密钥body: JSON.stringify({ model: deepseek-v4-flash, messages: [{ role: user, content: question.value }], stream: stream.value, })接口入参规范model指定调用模型messages对话上下文数组role: user代表用户提问stream布尔值true开启 SSE 流式分片返回false同步返回完整结果3.3 非流式逻辑同步一次性返回const data await response.json(); content.value data.choices[0].message.content;关闭流式时接口阻塞等待 AI 完整生成回答后返回 JSON直接读取message.content完整文本赋值缺点是长文本等待时间长无实时反馈。3.4 流式输出核心ReadableStream 数据流处理1. 获取二进制读取器与解码器const reader response.body?.getReader(); const decoder new TextDecoder();response.bodyFetch 响应内置ReadableStream二进制流对象服务端持续推送二进制数据分片getReader()创建流读取器提供read()方法逐块拉取数据TextDecoder浏览器内置 API将二进制 Uint8Array 转 UTF-8 字符串解决中文乱码问题2. 循环读取分片 代码逐行深度拆解while (!done) { const { value, done: doneReading } await reader?.read(); done doneReading; const chunkValue buffer decoder.decode(value); buffer ; }整体逻辑概述while (!done)是无限循环读取二进制数据流只要服务端还在持续返回大模型 Token 分片循环就不会停止直到服务端推送结束标识[DONE]或流读取完毕done变为 true跳出循环。 整个流程本质一次拉取一小块二进制数据 → 拼接缓存 → 转字符串 → 解析文本 → 继续拉取下一块。逐行拆解1.while (!done)done自定义布尔标记初始值false代表「流是否读取完毕」循环条件只要流没有结束就持续执行读取逻辑终止条件两种场景会让done truereader.read()返回doneReading true服务端所有数据推送完成流自然关闭手动捕获到data: [DONE]结束标记主动赋值done true跳出循环2.const { value, done: doneReading } await reader?.read();①reader?.read()可选链?.response.body?.getReader()有可能返回undefined老旧浏览器不支持 ReadableStream使用可选链避免read() is not a function报错做兼容性兜底。②read()是异步方法必须加awaitreader.read()会阻塞等待直到浏览器收到服务端下发的一块二进制分片才会 resolve 返回结果 如果当前没有新数据代码会挂起等待不会无限空跑循环不会占用 CPU。③ 返回值解构{ value, done: doneReading }read()执行后返回一个 Promise成功后得到对象{ value: Uint8Array | undefined, // 本次拿到的二进制字节数组 done: boolean // 原生流结束标记重命名为 doneReading 区分自定义done变量 }value本次从服务端拉取的二进制原始数据存储在Uint8Array类型数组中中文、英文、符号全部以二进制字节形式存在done: doneReading重命名变量防止和外层自定义done冲突。true服务端数据流彻底关闭不会再有新分片false还有后续数据继续循环读取。3.done doneReading;把原生流的结束状态同步给外层循环标记done。 当服务端传输完毕doneReading为 true赋值后下一轮while (!done)条件不成立循环终止。4.const chunkValue buffer decoder.decode(value);①decoder.decode(value)TextDecoder浏览器原生 API专门解析Uint8Array二进制数组将二进制字节转为 UTF-8 标准字符串完美解决中文多字节乱码问题单独解码单块value可能出现截断残缺字符串网络分片切割在一个汉字 / 一条 JSON 中间。②buffer 解码后的字符串buffer是全局缓存变量专门存放上一轮解析残缺、不完整无法解析的字符串片段。 举例场景 上一轮分片结尾只读到{delta:{content:你好JSON 不完整解析失败存入 buffer 本轮新分片开头是世界}}拼接后{delta:{content:你好世界}}形成完整可解析 JSON。5.buffer ;本轮缓存 新分片拼接完成chunkValue后清空缓存 后续解析chunkValue过程中如果再次遇到残缺 JSON再重新把残缺片段写入buffer等待下一轮拼接。完整运行流程示例初始done falsebuffer 进入循环await reader.read()等待服务端下发二进制块得到value二进制、doneReading falsedone false循环继续二进制转字符串和空 buffer 拼接得到完整chunkValue清空 buffer解析chunkValue内所有data:数据行若解析过程有残缺 JSON将残缺片段存入 buffer回到循环开头再次拉取下一块二进制分片自动拼接上一轮残缺缓存关键设计目的buffer 分片容错网络传输时服务端的一行完整 SSE 数据可能被拆成 2~3 个二进制包分次下发包 1data: {delta:{content:我今包 2天去公园}}\n只解析单包会 JSON.parse 报错依靠buffer跨循环拼接分片保证一定拿到完整 JSON 字符串再解析是流式处理必不可少的容错逻辑。3. 过滤 SSE 标准数据行const lines chunkValue .split(\n) .filter((line) line.startsWith(data: ));大模型 SSE 协议规范每一条数据以data:开头换行分隔过滤无关空行、注释行只保留有效业务数据。4. JSON 解析与增量文本拼接for (const line of lines) { if (line data: [DONE]) { done true; break; } const jsonStr line.replace(data: , ); try { const resJson JSON.parse(jsonStr); const deltaText resJson.choices[0].delta.content || ; content.value deltaText; } catch (err) { buffer line; } }data: [DONE]服务端流结束标识终止读取循环delta.content流式独有增量字段每次只返回新增文字持续追加到content实现打字机效果try/catch容错JSON 解析失败代表分片不完整存入 buffer 等待下一轮合并三、完整可运行代码script setup // vue3 composition 组合 api // 业务逻辑聚合区分Vue2选项式分散写法 import { ref } from vue; // 响应式数据 const question ref(讲一个中国龙的故事); // 用户提问 const content ref(); // AI返回内容 const stream ref(true); // 是否开启流式输出开关 // 核心请求函数 const update async () { // 空输入拦截 if (!question.value) return; content.value 思考中...; // DeepSeek 接口地址 const endpoint https://api.deepseek.com/chat/completions; // 请求头携带鉴权密钥 const headers { Content-Type: application/json, Authorization: Bearer ${import.meta.env.VITE_DEEPSEEK_API_KEY}, }; // 发起POST请求 const response await fetch(endpoint, { method: POST, headers, body: JSON.stringify({ model: deepseek-v4-flash, messages: [{ role: user, content: question.value }], stream: stream.value, // 根据开关切换流式/一次性返回 }), }); // 分支1流式输出处理逻辑 if (stream.value) { content.value ; // 获取响应二进制读取器 const reader response.body?.getReader(); // 二进制转UTF-8文本解码器 const decoder new TextDecoder(); let done false; let buffer ; // 分片缓存防止单行数据截断 // 循环读取数据流直到流结束 while (!done) { // 读取一块二进制分片 const { value, done: doneReading } await reader?.read(); done doneReading; // 拼接缓存当前分片转字符串 const chunkValue buffer decoder.decode(value); buffer ; // 过滤SSE标准data: 前缀数据行 const lines chunkValue .split(\n) .filter((line) line.startsWith(data: )); // 遍历每一行分片JSON for (const line of lines) { // 服务端结束标识终止循环 if (line data: [DONE]) { done true; break; } // 截取data: 后面的JSON字符串 const jsonStr line.replace(data: , ); try { const resJson JSON.parse(jsonStr); // 增量文本delta追加到页面内容 const deltaText resJson.choices[0].delta.content || ; content.value deltaText; } catch (err) { // JSON解析失败存入缓存下一轮拼接处理 buffer line; } } } } else { // 分支2非流式一次性获取完整JSON const data await response.json(); content.value data.choices[0].message.content; } }; /script template div classcontainer !-- 提问输入区域 -- div label输入/label input classinput v-modelquestion / button clickupdate提交/button /div !-- 输出控制与展示区域 -- div classoutput div labelStreaming/label input typecheckbox v-modelstream / /div div{{ content }}/div /div /div /template style .container { /* flex纵向布局贴合文档流 */ display: flex; flex-direction: column; align-items: flex-start; justify-content: flex-start; height: 100vh; font-size: 0.85rem; } .input { width: 200px; } .output { margin-top: 10px; min-height: 300px; width: 100%; text-align: left; } button { padding: 0 10px; margin-left: 6px; } /style四、模板与样式说明Template输入框使用v-model双向绑定question按钮绑定点击事件触发请求复选框v-model绑定stream一键切换流式开关{{ content }}响应式渲染 AI 回答数据流更新页面自动刷新Style使用 flex 纵向布局适配页面全屏高度输出区域设置最小高度预留回答展示空间基础尺寸、边距优化保证基础交互观感五、环境配置与踩坑指南5.1 环境变量配置项目根目录新建.env文件VITE_DEEPSEEK_API_KEY你的DeepSeek密钥重启项目后import.meta.env可正常读取密钥。5.2 常见问题解决跨域报错本地开发前端直接请求 DeepSeek 接口会触发 CORS解决方案Vite 配置本地代理转发接口请求后端搭建中转接口前端请求自身服务由服务端调用大模型 API中文乱码必须使用TextDecoder解析二进制分片不可直接转字符串二进制分片无法正确识别多字节中文。JSON 解析报错网络分片截断单行 JSON依靠buffer缓存碎片不要直接丢弃解析失败的行。流读取无响应判断response.body是否存在低版本浏览器不支持ReadableStream可增加降级逻辑切换非流式模式。六、核心技术原理总结SSE 流式通信服务端长连接持续推送增量数据相比轮询、WebSocket 更适合大模型文本输出场景ReadableStream浏览器原生流式处理 API无需一次性加载全部响应数据分片处理节省内存Vue 响应式更新每次追加delta增量文本ref触发局部 DOM 更新实现实时打字效果组合式 API 优势接口请求、流处理、状态控制全部逻辑聚合在一处对比 Vue2 选项式代码更易维护、复用

相关推荐

玩物联网第 5 期:使用CH348芯片IO端口,控制红外灯和传感器报警
玩物联网第 5 期:使用CH348芯片IO端口,控制红外灯和传感器报警

系统拓扑:视频地址: https://v.douyin.com/i2voy4xqrhonode-red流json数据:[{"id": "cd3040d39f7937b9","type": "tab","label": "按钮,控制红外灯、报警","d… · 2026/11/22 3:49:02

RuoYi-Vue-Plus Docker 部署踩坑:MySQL 中文双重编码的根因与修复
RuoYi-Vue-Plus Docker 部署踩坑:MySQL 中文双重编码的根因与修复

现象 用 docker-compose 部署完 RuoYi-Vue-Plus 后,打开前端页面: ✅ 正常:按钮文字「新增」「修改」「删除」、表头「角色名称」「权限字符」❌ 乱码:左侧菜单、面包屑、表格中的中文角色名 乱码长这样:Ÿ¡†… · 2026/11/21 7:31:16

AI电子宠物技术解析:从QQ宠物到Codex伴侣
AI电子宠物技术解析:从QQ宠物到Codex伴侣

1. 桌面电子宠物的文艺复兴:从QQ宠物到AI伴侣 2005年,一只胖乎乎的企鹅从QQ客户端右下角蹦出来,对着1.5亿中国网民喊"主人好"的场景,构成了千禧年初最鲜活的互联网记忆。如今OpenAI用Codex技术让电子宠物以全新形态回归… · 2026/11/21 23:26:20

电工证包含什么证多久拿证 电工小白必看避坑指南
电工证包含什么证多久拿证 电工小白必看避坑指南

电工证包含什么证多久拿证 电工小白必看避坑指南 怕考不过白交培训费?别急,我来给你讲明白电工证包含什么证,多久拿证,怎么选培训,怎么备考,别再被忽悠了。… · 2026/11/22 3:47:48

初级电工证接线千万别踩坑,实操考试心里没底怕挂科?教你一招保过
初级电工证接线千万别踩坑,实操考试心里没底怕挂科?教你一招保过

初级电工证接线千万别踩坑,实操考试心里没底怕挂科?教你一招保过 你是不是也这样?手里攥着初级电工证接线的报名资料,心里却像揣了只兔子, 实操考试心里没底怕挂科… · 2026/11/22 3:47:48

姜堰电工证培训点地址报名入口与办理流程:工地太忙根本没时间复习考试?郑州报考避坑指南
姜堰电工证培训点地址报名入口与办理流程:工地太忙根本没时间复习考试?郑州报考避坑指南

姜堰电工证培训点地址报名入口与办理流程:工地太忙根本没时间复习考试?郑州报考避坑指南 工地太忙根本没时间复习考试?你不是一个人。很多建筑工人,尤其是电工,每天在高压电、高处作业、高温环境里干活,哪还有时间去备考?更别提还有人不知道去哪里报名… · 2026/11/22 3:47:48

在医院需要电工证吗全流程办理指南及官方报名入口详解
在医院需要电工证吗全流程办理指南及官方报名入口详解

在医院需要电工证吗全流程办理指南及官方报名入口详解 实操考试心里没底怕挂科,这几乎是每个准备考电工证的学员心里的真实写照。尤其是在医院这种特殊场所,电工证的重要性不言而喻。今天就来聊聊【在医院需要电工证吗】这个话题,带你搞懂为什么在医院电工… · 2026/11/22 3:47:48

梅州电工证在线查询怎么操作?考前押题帮你少走弯路
梅州电工证在线查询怎么操作?考前押题帮你少走弯路

梅州电工证在线查询怎么操作?考前押题帮你少走弯路 学历不高怕报不上名?别担心,梅州电工证在线查询其实并不难,关键是掌握正确的备考方法,尤其是 考前押题… · 2026/11/22 3:47:48

丰台哪里办理电工证通过率揭秘:实操考试心里没底怕挂科
丰台哪里办理电工证通过率揭秘:实操考试心里没底怕挂科

丰台哪里办理电工证通过率揭秘:实操考试心里没底怕挂科 你是不是也这样?明明已经准备了很久,可到了实操考试那天,心里还是没底,怕挂科?别担心,这几乎是所有想考电工证的朋友共同的担忧。尤其在丰台区,报考电工证的人越来越多,但真正能顺利通过考试的… · 2026/11/22 3:46:48

平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定

平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42

麻阳考电工证在哪里考内部消息你知道吗
麻阳考电工证在哪里考内部消息你知道吗

麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43

揭阳普宁电工证换证怎么操作?良心建议帮你理清流程
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程

揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43

平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定

平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42

麻阳考电工证在哪里考内部消息你知道吗
麻阳考电工证在哪里考内部消息你知道吗

麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43

揭阳普宁电工证换证怎么操作?良心建议帮你理清流程
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程

揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:37

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:30

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:32

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码