diff --git a/doc/api/process.md b/doc/api/process.md index 8b210a1e7c06..c26ff5e2e3f9 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -2723,8 +2723,10 @@ changes: * `path` {string | URL | Buffer | undefined}. **Default:** `'./.env'` -Loads the `.env` file into `process.env`. Usage of `NODE_OPTIONS` -in the `.env` file will not have any effect on Node.js. +Loads the `.env` file into `process.env`. If a variable is already defined in +`process.env`, its existing value takes precedence and is not overwritten by the +`.env` file. Usage of `NODE_OPTIONS` in the `.env` file will not have any effect +on Node.js. ```cjs const { loadEnvFile } = require('node:process');