在 vite 项目中,环境变量文件通过 .env、.env.local 和 .env.development 等命名约定来管理。vite 会自动加载这些文件中的变量,但只有以 vite_ 为前缀的变量才会被注入到客户端代码中。你可以通过 import.meta.env 对象在 javascript 或 typescript 文件中访问这些变量,例如 import.meta.env.vite_api_url。

如何配置不同环境下的变量文件
Vite 支持根据运行模式(development 或 production)自动加载不同的环境变量文件。默认情况下,.env 文件在所有模式下都会加载,而 .env.development 仅在开发模式下加载,.env.production 仅在构建生产版本时加载。.env.local 文件通常用于存放本地覆盖配置,不会被提交到版本控制系统中。

// .env VITE_APP_TITLE=MyApp // .env.development VITE_API_URL=http://localhost:3000/api // .env.production VITE_API_URL=https://api.example.com/api
在上述配置中,VITE_APP_TITLE 会在所有环境中可用,而 VITE_API_URL 会根据当前模式使用不同的值。这种机制允许你在开发和生产环境中使用不同的 API 端点或其他配置。
立即学习“Java免费学习笔记(深入)”;
如何在代码中安全地访问环境变量
在 Vite 项目中,你可以通过 import.meta.env 对象访问环境变量。这个对象包含了所有以 VITE_ 为前缀的环境变量。需要注意的是,只有以 VITE_ 为前缀的变量才会被暴露给客户端代码,其他变量仅在服务端可用。

const apiUrl = import.meta.env.VITE_API_URL;
const appTitle = import.meta.env.VITE_APP_TITLE;
console.log(`API URL: ${apiUrl}`);
console.log(`App Title: ${appTitle}`);
通过这种方式,你可以在组件或模块中安全地访问环境变量。如果某个环境变量未定义,import.meta.env 会返回 undefined,因此建议在访问时使用可选链或默认值来避免运行时错误。
如何处理未定义的环境变量
当访问未定义的环境变量时,import.meta.env 会返回 undefined。为了避免运行时错误,可以使用默认值或条件判断来处理这种情况。例如,你可以提供一个默认 API URL,以防 VITE_API_URL 未定义。
const apiUrl = import.meta.env.VITE_API_URL || 'http://localhost:3000/api'; const appTitle = import.meta.env.VITE_APP_TITLE ?? 'Default App';
这种处理方式确保了即使环境变量未配置,应用也能正常运行。推荐使用空值合并运算符(??)或逻辑或运算符(||)来提供默认值,以提高代码的健壮性。


















