在 javascript 中模拟环境变量,核心做法是修改全局对象 process.env 的属性值。对于 node.js 环境,直接赋值即可生效;对于浏览器或打包工具(如 vite、webpack),则需使用插件将源码中的常量替换为指定值。具体操作时,注意区分模块加载时机:node.js 中动态修改仅对后续引入的模块有效,而构建工具通常在编译阶段完成替换。

Node.js 运行时如何动态注入变量
在 Node.js 脚本执行期间,可以通过直接修改 process.env 对象来模拟环境变量。这种方式适用于测试脚本或需要临时覆盖配置的场景。需要注意的是,这种修改是进程级别的,且必须在目标模块被 require 或 import 之前完成,否则已缓存的模块不会感知到变化。

const path = require('path');
// 1. 定义要模拟的环境变量
const mockEnv = {
NODE_ENV: 'test',
API_URL: 'http://localhost:3000',
SECRET_KEY: 'mock-secret-123'
};
// 2. 在引入业务模块前,合并到 process.env
Object.assign(process.env, mockEnv);
// 3. 验证变量是否生效
console.log(process.env.NODE_ENV); // 输出: test
console.log(process.env.API_URL); // 输出: http://localhost:3000
// 4. 引入依赖该变量的业务模块
const app = require('./app');
app.start();
上述代码展示了标准的注入流程。首先定义一个包含所有模拟值的对象,然后使用 Object.assign 将其合并到 process.env。这样做的好处是保留原有的其他环境变量,只覆盖需要的部分。随后立即引入业务逻辑,确保模块初始化时读取到的是模拟值。如果需要在测试结束后恢复原状,可以提前备份 process.env 并在测试清理阶段还原。
立即学习“Java免费学习笔记(深入)”;
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
Vite 等构建工具如何静态替换变量
在使用 Vite 进行前端开发时,环境变量需要在构建或启动服务器时被静态替换。Vite 默认只暴露以 VITE_ 开头的环境变量给客户端代码。通过在项目根目录创建 .env.test 文件并设置变量,可以在运行 vite --mode test 时自动加载这些值。构建工具会将源码中的 import.meta.env.VARIABLE_NAME 替换为具体的字符串字面量。

// .env.test
VITE_API_BASE_URL=https://api.staging.com
VITE_ENABLE_MOCK=true
// src/config.js
export const config = {
apiUrl: import.meta.env.VITE_API_BASE_URL,
isMockEnabled: import.meta.env.VITE_ENABLE_MOCK === 'true'
};
// 运行命令
// vite --mode test
这段配置展示了 Vite 的标准用法。在 .env.test 中定义的变量必须以 VITE_ 为前缀,否则不会被暴露给客户端。在代码中通过 import.meta.env 访问这些值。当执行 vite --mode test 时,Vite 会加载对应的环境变量文件,并在编译时将 import.meta.env.VITE_API_BASE_URL 替换为 'https://api.staging.com'。这种方式的优势在于安全性,敏感信息不会泄露到生产构建中,因为生产环境加载的是不同的 .env 文件或不加载测试文件。
未定义的环境变量在代码中返回什么值
当代码尝试访问一个未在 process.env 或构建配置中定义的环境变量时,其返回值取决于运行环境。在 Node.js 中,未定义的属性访问会返回 undefined。在 Vite 等现代构建工具中,如果引用的变量不存在,编译后的代码通常会保留为 undefined 或者抛出错误,具体取决于配置。为了避免运行时错误,建议在访问环境变量时使用空值合并运算符 ?? 提供默认值。

















