理论部分写大模型应用最常见的“第一道坎”不是算法而是环境与配置。一个可复现的项目通常需要三件事隔离的 Python 环境避免“这台电脑能跑、那台电脑不能跑”的依赖冲突统一的依赖清单用requirements.txt固定依赖范围安全的密钥管理API Key 永远不要写死在代码里使用.env/ 环境变量读取本项目使用的配置方式是用.env保存敏感信息再用python-dotenv读取调用模型侧使用openaiSDK因为部分厂商兼容 OpenAI 协议这样后续切换模型平台成本更低。实践部分本案例做什么创建并激活虚拟环境安装项目依赖配置.env并用一段最小 Python 代码验证配置是否生效1创建虚拟环境并激活在项目根目录执行python3-mvenv .venvsource.venv/bin/activate如果是 Windowspython-mvenv .venv .\.venv\Scripts\activate2安装依赖pipinstall-rrequirements.txt依赖文件位于项目根目录requirements.txt3配置.env项目提供了模板文件.env.example我们需要在项目根目录新建.env文件或复制.env.example并改名为.env然后填入真实 KeyZHIPUAI_API_KEY你的真实Key ZHIPUAI_BASE_URLhttps://open.bigmodel.cn/api/paas/v4/4验证配置是否生效主要代码把下面代码保存为check_env.py放在项目根目录即可用于验证环境变量读取是否正常importosfromdotenvimportload_dotenvdefmask_secret(value:str,left:int4,right:int4)-str:ifnotvalue:returniflen(value)leftright:return**len(value)returnf{value[:left]}{**(len(value)-left-right)}{value[-right:]}defmain()-None:load_dotenv()api_keyos.getenv(ZHIPUAI_API_KEY,)base_urlos.getenv(ZHIPUAI_BASE_URL,)ifnotapi_key:raiseRuntimeError(未检测到 ZHIPUAI_API_KEY请检查 .env 是否存在且已填写)print(✅ 环境变量加载成功)print(fZHIPUAI_BASE_URL {base_urlor(未设置)})print(fZHIPUAI_API_KEY {mask_secret(api_key)})if__name____main__:main()5运行结果在虚拟环境已激活的前提下执行python3 check_env.py运行后会看到类似输出Key 会被打码✅ 环境变量加载成功 ZHIPUAI_BASE_URL https://open.bigmodel.cn/api/paas/v4/ ZHIPUAI_API_KEY abcd****************wxyz如果出现报错未检测到 ZHIPUAI_API_KEY检查.env是否放在项目根目录、变量名是否写对、是否忘了填值ModuleNotFoundError: No module named dotenv说明依赖没装成功重新执行pip install -r requirements.txt总结这一篇我们完成了“可复现开发环境”的搭建虚拟环境、依赖安装、以及.env配置验证。