Sveltejs Academy · 课时

环境变量:$env/static 与 $env/dynamic

在 SvelteKit 中安全地访问服务器端和客户端的环境变量

第 3 / 4 课13 个步骤

环境变量:$env/static 与 $env/dynamic 是 CoddyKit 上的免费 Sveltejs Academy 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Sveltejs Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Sveltejs Academy 课程共包含 4 节课。

SvelteKit 环境变量 API

SvelteKit 通过四个模块公开环境变量:静态私有、静态公开、动态私有和动态公开。

静态私有

在构建时读取,仅限服务器使用,并会从客户端程序包中移除。

import { DB_URL } from "$env/static/private";

静态公开

在构建时读取,名称必须以 PUBLIC_ 开头,并会包含在客户端程序包中。

import { PUBLIC_API_URL } from "$env/static/public";

动态私有

在服务器运行时读取。适合在不重新构建的情况下更改配置。

import { env } from "$env/dynamic/private";
console.log(env.SECRET);

动态公开

在运行时读取,客户端和服务器都可以使用。名称必须以 PUBLIC_ 开头。

选择合适的类型

如果值在运行时不会改变,请使用静态类型;如果会改变,请使用动态类型(例如功能开关)。

机密永不公开

永远不要给机密加上 PUBLIC_ 前缀,否则它们会泄露到客户端程序包中。

环境变量文件

将值存储在 .env(已加入 Git 忽略)和 .env.example(已提交)中。

类型安全

静态变量会自动获得类型。动态变量通过 Record<string, string> 获得类型。

Vercel 和 Cloudflare

每个平台都有自己的环境变量界面。请有意地在各个环境之间同步配置。

测试

如果测试依赖环境变量模块,请在测试中模拟这些模块。

快速检查

公开环境变量必须使用什么前缀?

回顾

使用 $env/static/private 存放机密,使用带 PUBLIC_ 前缀的变量存放客户端可安全使用的值。根据需求选择静态或动态类型。

免费开始

用 AI 导师学习 HTML — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
41
课程
163

常见问题解答

「环境变量:$env/static 与 $env/dynamic」课时是免费的吗?

是的 — 「环境变量:$env/static 与 $env/dynamic」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Sveltejs Academy 课程的其余内容,请升级到 CoddyKit PRO。 Sveltejs Academy 课程共包含 4 节课。

「环境变量:$env/static 与 $env/dynamic」这节课中我会学到什么?

在 SvelteKit 中安全地访问服务器端和客户端的环境变量 你通过在浏览器中直接运行的动手代码来练习 Sveltejs Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Sveltejs Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Sveltejs Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 3 节课,共 4 节。

「环境变量:$env/static 与 $env/dynamic」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Sveltejs Academy 课中编写并运行代码吗?

能。每节 Sveltejs Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 表单操作中的 CSRF 防护
  2. {#html} 中的 XSS 防护
  3. 环境变量:$env/static 与 $env/dynamic
  4. 使用钩子进行速率限制
← 返回 Sveltejs Academy