如何在 Go 项目中集成 DeepSeek API 实现智能问答功能-Golang-PHP中文网

应直接使用 cohesion-org/deepseek-go 客户端，它已封装认证、重试、流式响应和错误映射；手动构造 http 请求易遗漏 content-type、错配 authorization 格式或在流式场景下导致 goroutine 卡死。

如何在 go 项目中集成 deepseek api 实现智能问答功能

直接用 cohesion-org/deepseek-go 客户端，别手写 HTTP 请求。它已封装好认证、重试、流式响应和错误映射，自己拼 http.NewRequest 容易漏掉 Content-Type、搞错 Authorization 格式，或在流式场景下卡死 goroutine。

用 `cohesion-org/deepseek-go` 初始化客户端

这个库不是官方 SDK，但比裸调更稳，且支持多后端（DeepSeek 官方、Azure、Ollama）。初始化时必须显式传入 API_KEY 和 Endpoint，否则默认会连 https://api.deepseek.com/v1 并因密钥缺失直接 401。

Endpoint 要带完整路径，比如 "https://api.deepseek.com/v1"，不能只写 "https://api.deepseek.com"
若对接 Azure，Endpoint 应为 "https://<your-resource-name>.openai.azure.com/openai/deployments/<deployment-id>/chat/completions?api-version=2024-02-15-preview"</deployment-id></your-resource-name>，且需额外设 AzureAPIKey
环境变量方式更安全：os.Getenv("DEEPSEEK_API_KEY")，别硬编码进 main.go

构造符合 DeepSeek v1/chat/completions 规范的 message 数组

DeepSeek 的聊天接口严格要求 messages 是 role-content 对数组，且至少含一个 user 消息。常见错误是传单个 string 或把 system 提示塞进 prompt 字段——这会导致 400 或静默忽略。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

合法结构：[]deepseek.Message{{Role: "user", Content: "解释量子纠缠"}}
支持 system 角色，但必须放在最前：[]deepseek.Message{{Role: "system", Content: "你是一个物理教授"}, {Role: "user", Content: "..."}}
不支持 assistant 预填充历史（除非你做多轮对话管理），库不会帮你维护 conversation state
模型名必须准确：官方目前主流是 "deepseek-chat" 或 "deepseek-r1"，填错会返回 404

处理流式响应（stream=true）时避免阻塞和 panic

启用流式后，响应体是 SSE（Server-Sent Events）格式，每行以 data: 开头。库内部用 bufio.Scanner 逐行读取，但如果你在 handler 中直接 range 迭代 channel 而没加超时或断连检测，HTTP 连接可能 hang 住。

务必设置 http.Client.Timeout，建议 60 秒以上，因为 DeepSeek-R1 复杂推理可能耗时较长
流式回调函数里别做阻塞操作（如写大文件、同步 DB 查询），否则拖慢整个 stream pipeline
遇到 io.EOF 或 net/http: request canceled 要主动退出循环，否则 goroutine 泄漏
不要假设每条 data: 行都能成功 json.Unmarshal；有些行可能是空或 [DONE]，需跳过

本地开发时用 Ollama 代理绕过网络和配额限制

DeepSeek 官方 API 在国内访问不稳定，且免费额度有限。用 cohesion-org/deepseek-go 切换到本地 Ollama 只需改两处，适合调试 prompt 工程或测试流式逻辑。

Ollama 启动命令：ollama run deepseek-coder:33b（注意模型名要匹配 Ollama 中实际存在的 tag）
客户端 Endpoint 改为 "http://localhost:11434/v1"，无需 API_KEY
Ollama 不支持 system role，所有上下文得塞进 user 消息里，或改用 deepseek-ai/deepseek-v3 等兼容镜像
性能差异明显：Ollama 在 CPU 上跑 deepseek-v3 可能要 10+ 秒首 token，别误判为代码卡死

真正难的不是调通第一个请求，而是让流式响应在高并发下不丢帧、不 panic，以及在切换不同后端（官方/Azure/Ollama）时保持 message 结构和错误处理逻辑一致。这些细节库帮你挡了一半，剩下一半得靠你在 handler 里加 context.WithTimeout 和 recover。