Vite环境下uniapp Vue 3项目添加和使用环境变量的完整指南

一、引言

在uniapp项目中，合理配置环境变量对于提高开发效率和保障项目安全至关重要。Vite作为新一代的前端构建工具，为环境变量的管理提供了简洁而强大的支持。下面，我们将一步步学习如何在Vite环境下为uniapp Vue 3项目添加和使用环境变量。

二、环境变量的设置

1. 创建环境变量文件

在项目根目录下，创建以下环境变量文件：

• .env.development：开发环境变量
• .env.test：测试环境变量
• .env.production：生产环境变量

2. 定义环境变量

以开发环境为例，在.env.development文件中添加以下内容：

# API接口地址
VITE_API_BASE_URL=https://api.development.example.com

# 其他自定义变量
VITE_OTHER_VARIABLE=development_value

注意：在Vite中，环境变量名使用VITE_作为前缀。 

三、在Vue 3项目中引用环境变量

1. 在组件中使用环境变量

在Vite环境下，您可以在Vue 3组件中直接通过import.meta.env来访问环境变量。以下是一个示例：

<template>
  <div>
    <p>API Base URL: {{ apiBaseUrl }}</p>
  </div>
</template>

<script>
export default {
  name: 'EnvironmentVariablesDemo',
  data() {
    return {
      apiBaseUrl: import.meta.env.VITE_API_BASE_URL
    };
  }
}
</script>

2. 环境变量加载

Vite会根据当前的模式（通过--mode命令行参数指定）自动加载相应的环境变量文件。例如，在开发模式下，Vite会加载.env.development文件。

四、环境区分

在Vite项目中，您可以通过以下命令来指定不同的环境：

# 开发环境
vite --mode development

# 测试环境
vite --mode test

# 生产环境
vite --mode production

五、总结

通过以上步骤，我们成功地在Vite环境下为uniapp Vue 3项目添加了环境变量，并在组件中正确引用了这些变量。这种方法使得我们能够根据不同的开发阶段，轻松切换配置，从而提高开发效率和项目的可维护性。在实际项目中，可以根据需求添加更多的环境变量，以满足多样化的开发场景。Vite的环境变量管理简单高效，值得在项目中推广使用。