场景还原:新项目刚克隆下来,README 写着后端 FastAPI、前端 Next.js、AI 模块用 OpenAI 和 Claude API、本地推理跑 Ollama,还要求 Node 24 LTS + Python 3.13。开发者A折腾了两天还在配环境,开发者B在 Slack 上发出了那条经典消息——“It works on my machine”。半小时后,开发者B的同事告诉他:
“你的
.env里有 API Key,刚刚你提交到 GitHub 了——已经有人用它在跑 GPT-5.4 Pro,30 美元/百万 Token,跑了 500 万 Token。”环境配置、版本管理、依赖隔离、密钥安全、API 调用——AI 时代的全栈开发,门槛藏在第一条
git clone的背后。不夸张地说,乱配环境,是真会破产的。接下来,我们把地基一锤子一锤子敲实。
一、问题诊断
做过全栈 + AI 项目的人,多少经历过下面这些画面:
- Node.js 版本不对,前端跑不起来,
nvm use 24解决了,切到 Python 后端项目,pip install死活找不到包——系统上三个 Python 版本,which python和which python3指向不同路径,虚拟环境还