从零到LangChain实战：在Windows上用VSCode+Jupyter搭建你的第一个AI应用原型

从零到LangChain实战在Windows上用VSCodeJupyter搭建你的第一个AI应用原型当ChatGPT掀起生成式AI的浪潮时许多开发者都渴望亲手构建自己的智能应用。LangChain作为当前最热门的AI应用开发框架让普通开发者也能像搭积木一样组合大语言模型的能力。但面对琳琅满目的技术文档新手往往在环境配置阶段就望而却步——这正是本文要解决的问题。不同于传统先学理论再实践的路径我们将采用项目驱动式学习法从克隆一个现成的AI问答项目开始在1小时内完成从开发环境搭建到第一个可运行原型的全过程。你不仅会获得即时反馈的成就感更能直观理解LangChain如何将大语言模型转化为实际应用。1. 极简开发环境配置1.1 基础工具三件套现代Python开发离不开三个核心工具Git版本控制与代码管理Python 3.11LangChain官方推荐版本VSCode轻量级全能IDE建议直接使用官方安装包而非包管理器避免权限问题# 验证安装成功的命令 git --version python --version code --version1.2 依赖管理的优雅方案传统pip直接安装常导致包冲突我们改用更现代的解决方案工具作用安装命令Poetry项目级依赖隔离pip install poetryJupyter插件交互式开发环境VSCode扩展商店搜索安装提示在VSCode中按CtrlShiftX可快速打开扩展市场搜索安装Jupyter和Python两个官方扩展2. 五分钟启动示例项目2.1 克隆预配置仓库跳过从零创建的繁琐过程直接获取我们精心准备的LangChain-OpenTutorialgit clone https://github.com/LangChain-OpenTutorial/LangChain-OpenTutorial.git cd LangChain-OpenTutorial这个仓库已包含预配置的pyproject.toml依赖清单示例Notebook文件测试用文档数据集2.2 一键初始化环境在项目根目录执行poetry install # 自动安装所有依赖 poetry shell # 激活虚拟环境首次运行可能需要3-5分钟下载依赖具体时长取决于网络状况3. 第一个AI问答原型3.1 启动Jupyter Notebook在VSCode中打开项目文件夹点击左侧活动栏的Jupyter图标打开examples/01_quickstart.ipynb注意如果提示选择内核务必选择Python Environments下的项目虚拟环境通常以项目名称为前缀3.2 运行文档问答示例这个预置Notebook展示了LangChain最典型的应用场景——基于本地文档的智能问答。核心代码段如下from langchain.document_loaders import DirectoryLoader from langchain.indexes import VectorstoreIndexCreator # 加载项目内的示例文档 loader DirectoryLoader(data/, glob*.txt) index VectorstoreIndexCreator().from_loaders([loader]) # 提出你的第一个问题 query LangChain的主要组件有哪些 print(index.query(query))执行后会看到类似输出LangChain主要包含Model I/O、Retrieval、Chains、Memory、Agents等核心模块...4. 开发技巧与优化实践4.1 实时调试建议当代码出现异常时试试这些诊断命令import langchain print(langchain.__version__) # 确认版本 print([m for m in dir(langchain) if not m.startswith(_)]) # 查看可用模块4.2 性能优化配置在pyproject.toml中添加这些可选依赖可以提升响应速度[tool.poetry.dependencies] faiss-cpu ^1.7.4 # 本地向量搜索加速 openai ^0.27.8 # 如需接入GPT模型4.3 扩展应用场景修改示例代码中的data/目录你可以轻松实现个人知识库问答技术文档解析助手会议纪要摘要生成5. 常见问题速查手册QPoetry安装超时怎么办A配置国内镜像源poetry config repositories.pypi https://pypi.tuna.tsinghua.edu.cn/simple/QJupyter内核找不到虚拟环境A在VSCode命令面板CtrlShiftP执行 Jupyter: Select Notebook KernelQ运行时报SSL证书错误A临时解决方案开发环境适用import os os.environ[REQUESTS_CA_BUNDLE] 在完成第一个原型后建议尝试修改query内容体验不同提问方式或是向data/文件夹添加自己的txt文档测试解析能力。我最近将一个客户的产品手册放入该系统仅用半小时就搭建出了可用的内部知识问答系统——这种快速验证想法的能力正是LangChain最迷人的地方。