Vite 支持在 index.html 中通过 %ENV_NAME% 语法直接注入环境变量，但需注意语法格式、引号处理及 .env 文件配置规范，否则会导致变量未定义或 JS 解析错误。
如何在 vite 项目中安全地在 index.html 中访问环境变量：vite 支持在 index.html 中通过 `%env_name%` 语法直接注入环境变量，但需注意语法格式、引号处理及 `.env` 文件配置规范，否则会导致变量未定义或 js 解析错误。
在 Vite 项目中，index.html 是静态 HTML 模板文件，在构建阶段由 Vite 预处理并注入环境变量——而非运行时通过 JavaScript 访问 import.meta.env。这意味着你不能像在 .ts/.js 文件中那样直接使用 import.meta.env.VITE_MY_VAR，也不能依赖 Node.js 的 process.env（浏览器环境根本不存在该对象）。Vite 提供了专为 HTML 设计的环境变量替换机制，其核心规则如下：
✅ 正确用法：使用 %VARIABLE_NAME% 占位符（Vite v4+）
在 <script></script> 或任意 HTML 文本中，直接写入 %VITE_MY_VAR%，Vite 会在构建时将其原样替换为 .env 中定义的值（自动处理转义）：
<script>
console.log('my env var:', '%VITE_MY_VAR%');
</script>若 .env 文件内容为：
VITE_MY_VAR=Hello World
构建后生成的 index.html 将变为：
<script>
console.log('my env var:', 'Hello World');
</script>⚠️ 关键注意事项：
立即学习“前端免费学习笔记（深入）”；
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
-
不要加引号或分号：
.env中的值应写为VITE_MY_VAR=Hello World，而非'HELLO WORLD';或"Hello World";—— 引号和分号会被原样保留，导致 JS 语法错误或字符串包含意外字符； -
占位符必须被引号包裹（JS 字符串场景）：
%VITE_MY_VAR%本身不是 JS 变量，而是纯文本替换。若用于字符串上下文（如console.log），务必用单/双/反引号包裹，否则会解析为未声明变量； -
不支持动态表达式或模板逻辑：
语法（如 EJS）在 Vite 中无效，Vite 不执行服务端模板渲染； - *仅匹配 `VITE_
前缀变量**：非VITE_` 开头的环境变量默认不会暴露给前端（安全限制），确保变量名符合命名规范。
? 推荐实践示例：.env 文件：
VITE_APP_TITLE=My Awesome App VITE_API_BASE_URL=https://api.example.com
index.html 中使用：
<title>%VITE_APP_TITLE%</title>
<script>
const API_BASE = '%VITE_API_BASE_URL%';
console.debug('API endpoint:', API_BASE);
</script>? 进阶提示： 若需更复杂的环境配置（如多环境区分），可结合 Vite 的 --mode 参数与 .env.[mode] 文件（如 .env.production），Vite 会自动加载对应模式的变量。
总结：在 index.html 中访问环境变量的本质是构建时文本替换，而非运行时读取。坚持使用 %VITE_*% 语法、保持 .env 值简洁无引号/分号、并在 JS 中显式加引号，即可零成本、高可靠性地完成配置注入。
