在 npm 项目中区分生产环境和开发环境,核心做法是利用 package.json 中的 dependencies 和 devdependencies 字段分别声明两类依赖,并通过 node_env 环境变量控制运行时行为。安装时默认将 dependencies 下的包放入 node_modules,而 devdependencies 仅在开发或测试时需要;通过设置 node_env=production,应用代码可以跳过开发工具加载并启用优化逻辑。

如何配置 package.json 以分离依赖类型
要正确分离依赖,需在 package.json 中明确划分 dependencies 和 devDependencies。dependencies 包含应用运行所必需的核心库,如 express 或 react;devDependencies 包含构建、测试和代码检查工具,如 webpack、mocha 或 eslint。使用 npm install --save 添加的包默认进入 dependencies,而 npm install --save-dev 则将其加入 devDependencies。这种结构确保在生产部署时,仅安装 dependencies 中的包,从而减小包体积并提高安全性。

{
"name": "my-app",
"version": "1.0.0",
"dependencies": {
"express": "^4.18.2"
},
"devDependencies": {
"mocha": "^10.2.0"
}
}上述配置中,express 是生产依赖,mocha 是开发依赖。当执行 npm install 时,两者都会被安装到本地 node_modules。但在生产环境中,若使用 npm ci 或指定只安装生产依赖,则 mocha 不会被拉取。这种分离使得项目结构清晰,且便于团队协作时明确哪些包是必需的。
立即学习“Java免费学习笔记(深入)”;
如何通过 NODE_ENV 控制运行时行为
在代码中,通过读取 process.env.NODE_ENV 变量来区分当前环境。通常设置为 development、test 或 production。例如,在 Express 应用中,若 NODE_ENV 为 production,可禁用详细错误页面以提升安全性;若为 development,则可启用热重载和调试日志。许多第三方库也会根据此变量调整行为,如 React 在生产模式下移除警告信息以优化性能。

const express = require('express');
const app = express();
app.get('/', (req, res) => {
if (process.env.NODE_ENV === 'production') {
res.send('Production Mode');
} else {
res.send('Development Mode');
}
});
app.listen(3000);运行此代码时,若未设置 NODE_ENV,默认行为取决于框架实现,但通常建议显式设置。例如,在终端中执行 NODE_ENV=production node app.js 将触发生产模式逻辑。这种机制允许同一份代码在不同环境下表现不同,无需修改源码即可切换行为。
当 NODE_ENV 未设置时程序的行为是什么
若 NODE_ENV 环境变量未设置,process.env.NODE_ENV 的值为 undefined。在上述示例代码中,条件判断 process.env.NODE_ENV === 'production' 将返回 false,因此程序会执行 else 分支,输出 'Development Mode'。这意味着未设置该变量时,应用默认以开发模式运行,可能包含额外的调试信息和未优化的代码路径。为确保生产环境行为一致,建议在部署脚本中强制设置 NODE_ENV=production,避免意外回退到开发行为。


















