For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/guide/basic/env-vars.md.
close
Rslib
  • 简体中文

      • 环境变量

      本文介绍 Rslib 在生成库产物时，如何处理源码中的 import.meta.env.* 和 process.env.* 引用。

      默认行为

      Rslib 对不同产物格式中的内置 env 预设引用采用不同的处理方式：

      产物格式import.meta.envprocess.env.BASE_URL / process.env.ASSET_PREFIX其他 process.env.*
      ESM保留保留保留
      CJS替换为 undefined保留保留
      UMD / IIFE / MF内联 Rsbuild 的预设值内联 Rsbuild 的预设值保留

      表格中的预设值遵循 Rsbuild 的环境变量处理方式，详见 Rsbuild - 环境变量。

      保留的引用可以交由下游构建工具替换或目标运行时解析。

      在构建时替换为具体的值

      如果需要在构建库时将某个环境变量替换为具体的值，可以通过 source.define 显式定义：

      rslib.config.ts
      import { defineConfig } from '@rslib/core';

export default defineConfig({
  source: {
    define: {
      'import.meta.env.MODE': JSON.stringify('production'),
      'process.env.BASE_URL': JSON.stringify('/'),
    },
  },
});