Langchaingo 使用 DeepSeek-R1 需严格匹配 v0.1.0 版本、正确配置 BaseURL（https://api.deepseek.com）、Model（deepseek-reasoner）、Token，并显式设置 context 超时与流式回调；忽略任一细节均会导致 panic、空响应或乱码。
Langchaingo 不是“拿来就能跑”的开箱即用框架，它对版本、初始化参数、错误处理路径非常敏感——直接照抄旧教程大概率 panic 或返回空响应。
langchaingo.New 初始化必须显式指定 v0.1.0 版本
当前（2026年4月）最新版 langchaingo@v0.1.0 是唯一稳定支持 DeepSeek-R1 的版本。v0.2.x 已移除 openai.WithModel 等关键选项，v0.0.x 则缺少流式响应支持。
- 错误写法：
go get github.com/tmc/langchaingo/llms/openai（无版本号 → 拉取 unstable 分支） - 正确写法：
go get github.com/tmc/langchaingo@v0.1.0且必须同时指定子模块：go get github.com/tmc/langchaingo/llms/openai@v0.1.0 - 验证是否装对：
go list -m github.com/tmc/langchaingo输出应为github.com/tmc/langchaingo v0.1.0
DeepSeek-R1 调用必须用 openai 子包，但 BaseURL 和 Model 不能套 OpenAI 默认值
Langchaingo 的 openai 包本质是 OpenAI 兼容层，不是专为 OpenAI 设计——它靠 WithBaseURL 和 WithModel 切换后端，但默认值全指向 OpenAI，不改就必然 404 或 401。
-
WithBaseURL("https://api.deepseek.com")：注意末尾无/v1，加了会报404 Not Found -
WithModel("deepseek-reasoner")：不是deepseek-r1或deepseek-chat，错一个字符就返回model not found -
WithToken(os.Getenv("DEEPSEEK_KEY"))：环境变量名建议统一为DEEPSEEK_KEY，避免和 OpenAI 的OPENAI_API_KEY混淆
GenerateFromSinglePrompt 容易忽略 context 超时，导致请求卡死
DeepSeek-R1 推理耗时波动大，尤其复杂 prompt 下可能超过 30 秒。Langchaingo 默认不设超时，GenerateFromSinglePrompt 会一直阻塞，直到连接被服务端中断或客户端 panic。
立即学习“go语言免费学习笔记（深入）”；
- 必须用带超时的
context：ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second) - 调用后务必
defer cancel()，否则 goroutine 泄漏 - 错误处理不能只判
err != nil，还要检查completion是否为空字符串（DeepSeek 有时返回 200 + 空 body） - 示例片段：
ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second) defer cancel() completion, err := llms.GenerateFromSinglePrompt(ctx, llm, prompt) if err != nil { log.Fatal("API error:", err) } if completion == "" { log.Fatal("empty response from deepseek-reasoner") }
流式响应需手动启用，且不能混用非流式函数
GenerateFromSinglePrompt 是阻塞式、一次性收全响应；要实现流式输出（如 CLI 实时打印、WebSSE 推送），必须用 llm.GenerateContent 并传入 llms.WithStreamingFunc 回调。
- 流式调用前，确认
WithBaseURL指向https://api.deepseek.com（不是/v2或其他路径） - 回调函数内不要做耗时操作（如写文件、发 HTTP 请求），否则阻塞整个流
- 切勿在同一个
llm实例上交替调用GenerateFromSinglePrompt和流式方法——内部状态冲突会导致EOF或unexpected EOF - 最小流式示例：
streamFunc := func(ctx context.Context, chunk []byte) error { fmt.Print(string(chunk)) return nil } _, err := llm.GenerateContent(ctx, []llms.MessageContent{{ Role: llms.ChatMessageRoleUser, Parts: []llms.ContentPart{llms.TextContent{Text: prompt}}, }}, llms.WithStreamingFunc(streamFunc))
最常被跳过的细节：DeepSeek-R1 的流式响应 chunk 是 UTF-8 字节流，不是完整 JSON，chunk 可能截断在中文字符中间，直接 string(chunk) 可能出 符号——需要先用 bytes.Runes 或 utf8.DecodeRune 做边界校验再拼接。
