Node.js中process.env属性的定义位置与初始化时机解析

一、process.env属性的定义/来源位置 #

• 系统级环境变量：操作系统自带的环境变量（比如PATH、HOME），Node.js启动时会自动把这些加载到process.env里。
• 项目.env配置文件：这是Node.js项目最常用的方式，配合dotenv包使用。通常会在项目入口（比如index.ts）最顶部调用require('dotenv').config()或者import 'dotenv/config'，把.env文件里的键值对加载到process.env。你没找到初始化代码，大概率是dotenv的加载逻辑藏在你没注意的地方——比如全局配置文件、tsconfig的预加载设置，或者启动脚本里用node -r dotenv/config index.js这种参数预加载了。
• 启动命令行传递：启动Node.js时直接在命令行里传值，比如JWT_KEY=abc123 MONGO_URI=mongodb://localhost:27017 node index.js，这种方式不需要在代码里写赋值逻辑，启动时直接注入到process.env。
• 容器/部署平台注入：如果项目是用Docker、K8s或者云服务部署的，环境变量可能是通过容器配置、部署清单、平台控制台设置的，启动时自动注入到进程环境里，代码里完全看不到赋值痕迹。

二、初始化时机 #

• 系统环境变量：在Node.js进程启动之前就存在，进程启动时直接读取并注入到process.env。
• .env文件（配合dotenv）：调用dotenv.config()的瞬间完成加载，一般放在项目入口最开头，保证后续代码能拿到值。如果是用-r参数预加载，会在代码执行前就加载完毕。
• 命令行/容器注入：同样是在Node.js进程启动之前由启动环境注入，进程启动后直接就能用。
• 代码赋值：你看到的那处process.env.JWT_KEY赋值，是代码运行时动态修改的，优先级比前面几种方式高——因为后面的赋值会覆盖之前的内容。

三、值的存储位置 #

• 系统环境变量：存在操作系统的环境变量列表里，Windows用set命令查看，Linux/macOS用env命令查看。
• .env文件：明文存在项目目录下的.env文件里（这个文件通常会被.gitignore排除，不会提交到代码仓库），格式就是KEY=VALUE的键值对。
• 命令行传递：只在当前启动的进程生命周期内存在，进程结束后就消失了。
• 容器/部署平台：存在容器配置、部署资源清单或者平台的配置存储里（比如K8s的ConfigMap/Secret，云平台的环境变量配置面板），不会出现在代码仓库中。

内容的提问来源于stack exchange，提问作者GoodMan