在Webpack中,如何在不同环境中使用不同的API地址?

在 Webpack 中实现不同环境使用不同 API 地址,核心是通过环境变量配合 Webpack 插件动态注入配置。以下是具体实现步骤:

一、准备工作

  1. 安装必要依赖:

    bash 复制代码
    npm install dotenv-webpack --save-dev  # 用于加载 .env 文件
    npm install cross-env --save-dev       # 跨平台设置环境变量

二、实现步骤

1. 创建环境配置文件

在项目根目录创建不同环境的 .env 文件,存储对应环境的 API 地址:

env 复制代码
# .env.development(开发环境)
API_BASE_URL = 'http://dev-api.example.com'

# .env.test(测试环境)
API_BASE_URL = 'http://test-api.example.com'

# .env.production(生产环境)
API_BASE_URL = 'http://prod-api.example.com'
2. 配置 Webpack

修改 webpack.config.js,通过 dotenv-webpack 加载对应环境的配置,并使用 DefinePlugin 注入到代码中:

3. 在代码中使用 API 地址

直接通过 process.env.API_BASE_URL 访问当前环境的 API 地址:

javascript 复制代码
// src/api.js
export const api = {
  baseUrl: process.env.API_BASE_URL,
  getUser: () => fetch(`${process.env.API_BASE_URL}/user`)
};
4. 配置 package.json 命令

添加不同环境的构建命令,通过 cross-env 设置 NODE_ENV

json 复制代码
{
  "scripts": {
    "build:dev": "cross-env NODE_ENV=development webpack build",
    "build:test": "cross-env NODE_ENV=test webpack build",
    "build:prod": "cross-env NODE_ENV=production webpack build"
  }
}

三、关键说明

  1. 变量注入时机

    环境变量在构建阶段被注入代码(会被硬编码到打包后的文件中),而非运行时动态获取。

  2. 安全性注意

    前端代码中的环境变量会暴露在打包后的 JS 中,不要存放密钥、Token 等敏感信息

  3. 优先级规则

    • 命令行中设置的变量(如 cross-env API_BASE_URL=xxx)会覆盖 .env 文件中的配置
    • 可以创建 .env.local 存放本地开发配置(需加入 .gitignore,避免提交到仓库)
  4. Webpack 5 简化方案

    若使用 Webpack 5,可通过 webpack.DefinePlugin 直接读取 process.env,无需 dotenv-webpack

    javascript 复制代码
    new webpack.DefinePlugin({
      'process.env.API_BASE_URL': JSON.stringify(
        process.env.NODE_ENV === 'production' 
          ? 'http://prod-api.example.com' 
          : 'http://dev-api.example.com'
      )
    })

通过以上配置,执行不同的构建命令(如 npm run build:test)即可自动切换项目使用的 API 地址,无需手动修改代码。

相关推荐
JNX_SEMI13 分钟前
AT2401C 2.4GHz 全集成射频前端单芯片技术解析
前端·单片机·嵌入式硬件·物联网·硬件工程
anOnion31 分钟前
Agentic 前端开发之 实时显示 AI Agent 终端输出
前端·javascript·人工智能
随风一样自由41 分钟前
【前端领域】2026最新前端领域全梳理(框架/工具/AI/跨端/底层标准/就业趋势)
前端·人工智能·前端框架
这是个栗子41 分钟前
【前端性能优化】优化数据加载:用 Promise.all 从串行到并行
前端·javascript·性能优化·异步编程·前端优化·promise.all
fei_sun1 小时前
黑洞路由(Null Route/空接口路由)
服务器·前端·javascript
大爱一家盟2 小时前
告别卡点BGM同质化 2026原创卡点音乐素材下载网站 TOP5 推荐
大数据·前端·人工智能
彦为君2 小时前
算法思维与经典智力题
java·前端·redis·算法
aa小小2 小时前
localhost 访问异常排查笔记
前端
格子软件2 小时前
2026年GEO优化系统源码的分布式状态机深度拆解
java·前端·vue.js·vue·geo
陈随易3 小时前
Rust、Golang、MoonBit 编译成 WASM,体积和速度差距有多大?
前端·后端·程序员