前言为什么你需要这篇指南痛点直击官方文档晦涩难懂英文门槛高概念堆砌新手一头雾水环境搭建处处是坑pip安装超时、依赖冲突、导入报错模型对接失败率高密钥配置错误、API调用超时、代码跑不通国产模型适配迷茫通义千问、DeepSeek等主流国产模型如何快速接入本文核心优势零废话、纯实操规避复杂理论只讲新手必懂核心5分钟落地见效从零到一跑通首个LLM对话应用双模型适配同时适配通义千问、DeepSeek两大主流国产模型全程可复制代码逐行注释命令直接粘贴运行适合人群Python小白想快速上手AI应用开发后端开发者需要集成大模型能力AI入门学习者希望掌握LangChain核心逻辑想快速上手大模型应用的新手学习收获掌握LangChain核心调用逻辑独立跑通首个LLM对话应用学会一键切换两大主流国产模型获得完整可运行的代码模板一、LangChain 核心认知小白秒懂版规避复杂理论只讲新手必懂核心内容1.1 什么是LangChain一句话通俗解释大模型应用开发的脚手架帮你快速封装LLM能力无需重复造轮子。就像盖房子不需要从烧砖开始LangChain提供了现成的砖块组件让你能快速搭建对话系统、知识库、智能Agent等应用。1.2 为什么新手要学LangChain告别重复造轮子API调用、对话管理、记忆存储等通用功能都已封装好快速搭建应用几分钟就能跑通一个可用的AI对话应用生态丰富支持国内外主流大模型OpenAI、通义千问、DeepSeek等降低学习成本统一接口切换模型只需改几行代码1.3 本文用到的核心组件极简介绍LLM大模型模块对接具体的大模型如通义千问、DeepSeekPromptTemplate提示词模板规范AI的输入输出让回答更可控1.4 环境前置要求Python 3.8推荐3.9或3.10网络环境能访问国内镜像源和模型API零基础可适配本文假设你是Python新手所有步骤都会详细说明二、零基础环境搭建全程可复制重点适配国内环境规避pip下载慢、导入报错问题2.1 核心依赖安装命令使用清华镜像加速解决下载超时问题# 设置清华镜像源临时 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple langchain langchain-community dashscope 或者永久设置镜像源 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip install langchain langchain-community dashscope2.2 关键包说明langchainLangChain核心库提供基础框架langchain-community社区维护的第三方模型集成重要包含通义千问等国产模型支持dashscope阿里云通义千问的Python SDK2.3 新手常见报错解决ImportError: No module named langchain_community# 解决方案确保安装的是最新版本 pip install --upgrade langchain-community 或者重新安装 pip uninstall langchain-community -y pip install langchain-community2.4 模型密钥获取教程通义千问免费密钥申请访问 阿里云DashScope平台注册/登录阿里云账号可用支付宝快速登录进入模型服务 → API-KEY管理点击创建API-KEY复制保存免费额度足够新手使用DeepSeek密钥申请访问 DeepSeek官网注册账号并登录进入API Keys页面需要充钱新手10块钱足够用了点击Create new secret key复制保存三、5分钟极速实战跑通第一个LangChain LLM应用全文核心章节分步实操代码逐行注释直接复制运行3.1 基础配置环境变量导入避免密钥硬编码在代码中提高安全性# config.py 或直接在代码开头设置 import os 方式1直接设置环境变量临时 os.environ[DASHSCOPE_API_KEY] 你的通义千问API_KEY os.environ[DEEPSEEK_API_KEY] 你的DeepSeek API_KEY 方式2使用python-dotenv从.env文件加载推荐 先安装pip install python-dotenv 创建.env文件内容 DASHSCOPE_API_KEYsk-xxx DEEPSEEK_API_KEYsk-xxx3.2 实战一适配通义千问模型实现基础AI对话完整可运行代码import os from langchain_community.llms import Tongyi from langchain.prompts import PromptTemplate 设置API密钥替换成你的实际密钥 os.environ[DASHSCOPE_API_KEY] sk-你的通义千问API密钥 1. 初始化通义千问模型 llm Tongyi( model_nameqwen-max, # 使用qwen-max模型效果最好 temperature0.7, # 控制随机性0-1之间越大越有创意 top_p0.8, # 核采样参数控制多样性 ) 2. 基础对话测试 print( 通义千问基础对话测试 ) response llm.invoke(你好请用一句话介绍你自己) print(fAI回复{response}) print(- * 50) 3. 使用PromptTemplate规范对话 prompt_template PromptTemplate( input_variables[topic], template请用通俗易懂的方式向编程新手解释什么是{topic} ) 格式化提示词 formatted_prompt prompt_template.format(topic人工智能) print(f格式化后的提示词{formatted_prompt}) 4. 使用模板进行对话 response llm.invoke(formatted_prompt) print(fAI回复{response})运行结果展示 通义千问基础对话测试 AI回复你好我是通义千问一个由阿里云开发的大语言模型... -------------------------------------------------- 格式化后的提示词请用通俗易懂的方式向编程新手解释什么是人工智能 AI回复人工智能就像给电脑装上了一个会学习、会思考的大脑...常见问题排查报错Invalid API Key检查密钥是否正确确保已开通通义千问服务请求超时检查网络连接国内用户建议使用阿里云国内节点模型不存在确认model_name是否正确最新可用模型为qwen-max3.3 实战二适配DeepSeek模型一键切换大模型极简改造代码import os from langchain_community.llms import DeepSeek from langchain.prompts import PromptTemplate 设置API密钥切换为DeepSeek密钥 os.environ[DEEPSEEK_API_KEY] sk-你的DeepSeek API密钥 只需修改这一行其他代码完全一样 llm DeepSeek( modeldeepseek-chat, # DeepSeek模型名称 temperature0.7, top_p0.8, ) 使用相同的PromptTemplate prompt_template PromptTemplate( input_variables[topic], template请用通俗易懂的方式向编程新手解释什么是{topic} ) formatted_prompt prompt_template.format(topic机器学习) print(f DeepSeek模型测试 ) print(f问题{formatted_prompt}) response llm.invoke(formatted_prompt) print(fAI回复{response})两大模型效果简单对比通义千问中文理解强适合中文场景免费额度充足DeepSeek代码能力强上下文窗口大128K完全免费选择建议中文问答选通义千问代码生成选DeepSeek四、核心代码逻辑深度拆解小白彻底吃透不止会跑代码4.1 LLM调用核心流程密钥校验通过环境变量或配置文件加载API密钥模型初始化选择模型提供商Tongyi/DeepSeek并设置参数请求发送调用llm.invoke()方法发送提示词结果返回接收AI回复并进行后续处理4.2 PromptTemplate的核心作用统一输入输出确保每次对话格式一致规范对话逻辑引导AI按照特定结构回答提高可控性减少随机性获得更稳定的输出便于维护提示词与业务逻辑分离4.3 两大国产模型适配差异总结对比项通义千问 (Tongyi)DeepSeek初始化方式Tongyi(model_nameqwen-max)DeepSeek(modeldeepseek-chat)密钥环境变量DASHSCOPE_API_KEYDEEPSEEK_API_KEY免费额度新用户100万tokens完全免费优势场景中文理解、对话代码生成、长文本响应速度较快国内服务器稳定4.4 新手开发最佳实践密钥管理永远不要将密钥提交到Git使用.env文件gitignore版本适配固定关键包版本避免兼容性问题代码规范添加异常处理记录日志设置超时时间测试策略先用小额度测试确认无误再正式使用五、高频问题汇总新手专属避坑指南整合CSDN高频提问提升文章收藏、点赞、搜索权重Q1ImportError: No module named langchain_community 终极解决方案# 终极解决方案按顺序执行 # 1. 卸载重装 pip uninstall langchain langchain-community -y 2. 使用指定版本安装最稳定 pip install langchain0.1.0 pip install langchain-community0.0.10 3. 如果还有问题检查Python路径 python -c import sys; print(sys.path) 确保你的项目在Python路径中Q2模型调用超时、接口报错、密钥无效如何解决超时问题设置timeout参数增加重试机制接口报错检查模型名称是否正确查看官方文档更新密钥无效确认密钥是否过期是否开通对应服务通用方案添加异常捕获记录错误日志Q3通义千问/DeepSeek免费额度够用吗新手如何低成本使用通义千问新用户100万tokens足够学习和小项目开发DeepSeek完全免费无额度限制最适合新手练习省钱技巧本地测试用短文本正式环境再优化提示词