为帮助开发者快速吃透 LangChain 整体架构、解决入门难题，本文将拆解项目核心模块，并讲解在实际项目中，API Key的常用配置和dotenv代码实战，内容简洁易懂，兼顾理论认知与实际开发落地。
如果喜欢看视频学习的，可以看这个《7. 搞懂LangChain开发库，还有dotenv实战》，喜欢看文章的接着往下看。
1. LangChain项目工程
LangChain 项目采用职责清晰的模块化架构，核心模块定位与能力边界如下：
langchain-core：LangChain 全生态的核心基石，统一定义了生态内所有通用抽象接口、交互协议与核心数据结构，是所有上层组件与集成能力的底层依赖。
langchain-classic：历史版本兼容包，仅用于存量旧项目的平滑兼容与运维支撑，不推荐新项目引入使用。
langchain_v1：当前官方主推的生产级主用版本，核心聚焦大模型智能体（Agent）的全链路构建，封装了开箱即用的核心开发能力。
partners 集成库：由 LangChain 官方维护的第三方生态集成集合；其中 Anthropic、DeepSeek、OpenAI 等主流大模型的核心集成，均由 LangChain 官方与对应厂商联合开发维护，保障接口兼容性与长期稳定性。
其中，OpenAI API 已成为大模型服务领域的行业事实标准，目前绝大多数主流大模型厂商，均提供了与该标准完全兼容的 API 接口，可实现跨模型的低成本无缝切换。
2. 申请API Key
接入任意大模型平台的服务前，均需先在对应平台申请专属的 API 密钥（API Key），用于接口调用时的身份鉴权与调用额度管控。
针对个人开发者的开发测试场景，优先推荐阿里云百炼、火山引擎两大平台，二者均为个人开发者提供了充足的免费调用额度，可充分满足日常功能调试、原型验证的全流程需求。
进到阿里云百炼后台https://bailian.console.aliyun.com，点击【API Key】，进到创建API密钥的窗口。
找到右上角【创建API Key】按钮并点击，这时会弹出一个窗口。
直接点击【确定】按钮即可。
API Key创建好了，点击【复制】按钮并保存到本地文件(自己随意创建一个txt文件)。接着点击【关闭】按钮，之后点击【阿里云百炼logo】，回到主窗口。
在主窗口中，找到【免费额度】并进行点击。
为了避免大模型用量超额，你需要进行设置。找到右边【批量操作免费额度用完即停】按钮并进行点击。
在下拉菜单，点击【批量开启】选项。
操作不能停，还要按下【一键开启所有模型】按钮。
一开始时，我就开启过，现在是开启最近新增的模型，点击【开启免费额度用完即停】按钮。过一会就会全部开启完了。然后要使用的大模型名称并复制保存起来，建议选择最近的(比如qwen3.6-plus)，旧版的到一定时间会下架的。接着点击顶部【文档】链接。
找到代码中base_url，复制https://dashscope.aliyuncs.com/compatible-mode/v1并保存起来。注意，这里的示例代码是LangChain旧版本的。
3. 创建工程并进行dotenv实战
用PyCharm创建一个项目工程之后，创建main.py文件，内容如下，这种直接把API_Key写在代码里的做法叫硬编码，它最大的问题是不灵活：换大模型要改代码，还容易泄露密钥。
OPENAI_API_KEY=”你的API Key” OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1 MODEL=qwen3.6-plus
为保障调用凭证安全，可将API_KEY和BASE_UR配置至系统环境变量里。用户变量只对当前登录计算机的用户有效，系统变量对所有用户都有效。
配置之后，可以重启计算机生效，也可以通过如下方式生效。打开命令行窗口并运行如下命令进行刷新。接着需要退出命令行窗口，同时需要重启PyCharm。
set PATH=%PATH%
打开main.py文件，输入如下代码。os.getenv()函数，通过指定key获取环境变量的值，如果获取不到，会返回None。
import os import dotenv api_key=os.getenv("OPENAI_API_KEY") base_url=os.getenv("OPENAI_BASE_URL") print(api_key) print(base_url)在开发产品时，常将用户自己配置的API密钥和URL放在.env文件里。新建.env文件，API密钥的值，加点不一样的。
OPENAI_API_KEY=“你的API密码-666” OPENAI_BASE_URL=“https://dashscope.aliyuncs.com/compatible-mode/v1” MODEL=“qwen3.6-plus”
读写.env文件，需要用pip安装dotenv开发包。
pip install dotenv
用import语法引进dotenv；load_dotenv()，默认加载当前目录下的.env文件。
import os from dotenv import load_dotenv load_dotenv() api_key = os.getenv("OPENAI_API_KEY") base_url = os.getenv("OPENAI_BASE_URL") print(api_key) print(base_url)运行代码之后，你会发现，返回的还是系统环境变量里配置的值，这是因为同名下，系统环境变量优先级高。删掉系统环境变量里的OPENAI_API_KEY和OPENAI_BASE_URL。
打开命令行窗口并运行如下命令进行刷新。接着需要退出命令行窗口，同时需要重启PyCharm。
set PATH=%PATH%
打开main.py文件并运行之后，就会输出.env里的OPENAI_API_KEY和OPENAI_BASE_URL的值了。
你的API密码-666 https://dashscope.aliyuncs.com/compatible-mode/v1
4. dotenv应用实战
用PyCharm新建一个新的项目工程，用pip安装dotenv和pyside6。
pip install dotenv pyside6
在项目中，新建.env文件，如下是国内AI大模型厂家的API调用地址，在使用的时候，自己核对一下。
# ========== 阿里巴巴-通义千问 ========== QWEN_API_KEY='' QWEN_BASE_URL='https://dashscope.aliyuncs.com/compatible-mode/v1' QWEN_CONSOLE_URL='https://dashscope.console.aliyun.com/' QWEN_MODELS='qwen3.6-plus,qwen-3.5-plus,qwen-3.5-72b-instruct' # ========== 月之暗面 - Kimi ========== KIMI_API_KEY='' KIMI_BASE_URL='https://api.moonshot.cn/v1' KIMI_CONSOLE_URL='https://platform.moonshot.cn/' KIMI_MODELS='moonshot-v1-8k,moonshot-v1-128k,moonshot-v1-256k' # ========== MiniMax ========== MINIMAX_API_KEY='' MINIMAX_BASE_URL='https://api.minimax.chat/v1' MINIMAX_CONSOLE_URL='https://platform.minimax.chat/' MINIMAX_MODELS='abab-6.5-chat,abab-6.5-pro,minimax-m2.7,minimax-m2-her' # ========== 智谱AI-智谱清言 ========== ZHIPU_API_KEY='' ZHIPU_BASE_URL='https://open.bigmodel.cn/api/paas/v4' ZHIPU_CONSOLE_URL='https://open.bigmodel.cn/' ZHIPU_MODELS='glm-4.5-flash,glm-4.5-pro,glm-4-air' # ========== 字节跳动-豆包 ========== DOUBAO_API_KEY='' DOUBAO_BASE_URL='https://ark.cn-beijing.volces.com/api/v3' DOUBAO_CONSOLE_URL='https://console.volcengine.com/ark/' # 重要：豆包不直接使用模型名称，必须替换为火山方舟创建的推理接入点ID DOUBAO_MODELS='doubao-pro-32k,doubao-lite-32k,doubao-pro-128k' # ========== 百度-文心一言 ========== ERNIE_API_KEY='' ERNIE_BASE_URL='https://qianfan.baidubce.com/v2' ERNIE_CONSOLE_URL='https://console.bce.baidu.com/qianfan/' ERNIE_MODELS='ernie-4.0-turbo-8k,ernie-3.5-turbo-128k,ernie-speed-128k' # ========== 腾讯-混元 ========== HUNYUAN_API_KEY='' HUNYUAN_BASE_URL='https://api.hunyuan.cloud.tencent.com/v1' HUNYUAN_CONSOLE_URL='https://console.cloud.tencent.com/hunyuan/' HUNYUAN_MODELS='hunyuan-turbo,hunyuan-pro,hunyuan-lite' # ========== DeepSeek ========== DEEPSEEK_API_KEY='' DEEPSEEK_BASE_URL='https://api.deepseek.com/v1' DEEPSEEK_CONSOLE_URL='https://platform.deepseek.com/' DEEPSEEK_MODELS='deepseek-chat,deepseek-reasoner'
新建一个env_util.py文件，用来封装dotenv对.env文件的操作。
import os from dotenv import load_dotenv, set_key # @老陈说编程 哔哩哔哩、今日头条 class EnvUtil: def __init__(self, env_path=None): if env_path is None: self.env_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), ".env") else: self.env_path = env_path load_dotenv(self.env_path) def load_config(self, providers): config = {} for provider in providers: api_key = os.getenv(f"{provider}_API_KEY", "") base_url = os.getenv(f"{provider}_BASE_URL", "") console_url = os.getenv(f"{provider}_CONSOLE_URL", "") models_str = os.getenv(f"{provider}_MODELS", "") models = [m.strip() for m in models_str.split(",")] if models_str else [] config[provider] = { "api_key": api_key, "base_url": base_url,
