Node.js process.env 删除变量：赋成 undefined，为什么读到的仍然是字符串
在测试里临时关闭某项配置，把 process.env 的字段赋成 undefined，看起来像是清空变量。可是下一次读取时，它可能仍然存在，内容还是字符串 undefined。环境变量接口的赋值行为，不能直接按普通对象的直觉使用。
Node.js官方文档已经将赋值时的隐式字符串转换标为弃用，并提醒未来版本可能拒绝非字符串、数字或布尔值。下面对 undefined 的赋值仅用于复现当前行为；实际写入建议先明确转换成字符串，要删除就使用 delete，不依赖这条兼容路径。
程序在 Linux 上的 Node.js v24.19.0 实跑，保存为 demo.mjs，执行 node demo.mjs。它只使用一个专门的演示键，先保存该键原有状态，最后恢复；不会列出或打印其他环境变量。不要把整个 process.env 输出到调试日志。
AI模型生成概念示意：有内容的卡片、空白卡片与移除内容的槽位分别表示不同配置状态；图片不是环境变量查看器截图。
完整实验程序
import assert from 'node:assert/strict';
const key = 'YUNQUE_BATCH30_ENV_DEMO_13';
const existed = Object.hasOwn(process.env, key);
const original = process.env[key];
function show(label) {
console.log(label, 'present=' + Object.hasOwn(process.env, key),
'type=' + typeof process.env[key], JSON.stringify(process.env[key]));
}
function readBoolean(value) {
if (value === undefined) return false;
if (value === 'true') return true;
if (value === 'false') return false;
throw new TypeError('expected true or false');
}
try {
delete process.env[key];
show('missing');
// Deliberate legacy-behavior probe, not the recommended assignment.
process.env[key] = undefined;
assert.equal(process.env[key], 'undefined');
show('assigned undefined');
process.env[key] = '';
assert.equal(Object.hasOwn(process.env, key), true);
show('empty string');
delete process.env[key];
assert.equal(process.env[key], undefined);
show('deleted');
process.env[key] = String(false);
assert.equal(Boolean(process.env[key]), true);
assert.equal(readBoolean(process.env[key]), false);
console.log('explicit false', 'truthy=' + Boolean(process.env[key]),
'parsed=' + readBoolean(process.env[key]));
assert.throws(() => readBoolean(''), TypeError);
console.log('empty boolean', 'TypeError');
} finally {
if (existed) process.env[key] = original;
else delete process.env[key];
}本地实际输出
missing present=false type=undefined undefined assigned undefined present=true type=string "undefined" empty string present=true type=string "" deleted present=false type=undefined undefined explicit false truthy=true parsed=false empty boolean TypeError
同时看存在性、类型和具体内容
missing 与 deleted 两行都显示 present=false、type=undefined。assigned undefined 则是 present=true、type=string，后面的双引号明确指出内容为文字。若日志只是直接打印值，两种状态看起来过于相近，容易把兼容行为误认成变量已经删除。
empty string 仍然存在，只是内容长度为零。因此“未配置”和“显式传入空值”是否具有相同意思，要由读取函数决定。某些配置的空字符串代表禁用，另一些则应报错，不能在所有字段上统一套一个真假判断。
finally 按最初的存在性恢复状态：原先有这个键就写回原字符串，原先没有就删除。只记录原值、最后一律赋回去，会在原值是 undefined 时再次制造文字 undefined，正好重现本文的问题。
字符串 false 也需要按约定读取
explicit false 一行显示 truthy=true，但 parsed=false。String(false) 得到的是非空字符串，作为普通JavaScript条件自然为真；readBoolean 则只接受明确约定的 true、false 两种文字，并把缺失解释成默认关闭。
对空字符串的读取被TypeError拒绝，说明这份配置约定没有把空值默认为关闭。若产品需求不同，可以改变读取函数的规则，但要同步改变测试与说明。大小写是否兼容、是否允许前后空格，也应当在这个边界做出明确决定。
本次修改仅发生在当前Node进程的环境接口，不会把用户启动终端的变量一并改掉。测试框架里若有并发用例，应避免多个任务同时改同一个键；更容易隔离的设计是把配置对象传给待测函数。Windows主线程的环境变量名称还不区分大小写，跨平台代码不要把大小写差异当成两个独立开关。
参考资料
官方资料核验日期：2026-10-02。以上输出来自文中完整程序，断言通过，退出状态为零。
