本地跑得好好的，上线即崩

那天发生了什么

你准备了好几周，产品终于做好了。在自己的电脑上反复测试，一切完美。你信心满满地按下了部署按钮。

几分钟后，平台提示"构建失败"。你看了看报错信息，改了改配置，重新部署。这次构建通过了，但页面打开后是一片空白。

你开始排查问题。先是发现服务器上的 Node.js 版本和你本地的不同——某个你用到的语法特性在旧版本上不被支持。改了版本，页面能显示了，但功能不正常——因为你在本地设置的环境变量没有在服务器上配置。补上环境变量之后，又发现一个依赖包在 Linux 服务器上的行为和 macOS 上不一样……

每修好一个问题，就冒出下一个。你原本计划半小时搞定的部署，变成了一整天的环境排错。

"在我电脑上能跑"是开发界最著名的一句自嘲。它揭示了一个很多人忽略的事实：代码能否运行，不仅取决于代码本身，还取决于它运行的环境。

在你自己的电脑上开发了一段时间之后，你的电脑已经无声无息地积累了项目运行所需的一切条件——正确的工具版本、所有的依赖、本地的环境变量、特定的操作系统行为。但这些条件是你的电脑独有的。

服务器是一个干净的、全新的环境。你的电脑上"碰巧"满足的那些条件，在服务器上需要被明确地、一项一项地配置。任何一项遗漏，都可能导致代码无法正常运行。

在项目中维护一份清晰的环境说明。 让 AI 帮你记录：运行这个项目需要哪些工具？各自的版本是什么？需要配置哪些环境变量？

创建一个 .env.example 文件。 不放真实的密钥值，但列出所有需要的变量名和简短说明。这样无论是你在新电脑上操作，还是部署到服务器，都能按照这份清单逐项配置。

尽早部署一次。 不要等到所有功能做完再部署。在开发早期就做一次试部署，这样可以尽早发现环境差异，而不是等到最后关头才手忙脚乱。

部署后一定要实际访问和测试。 不要只看"部署成功"的提示就放心了。用另一台设备打开页面，实际操作一遍核心功能，确认它在线上环境中也能正常工作。