配置

是否使用哈希或随机数来限制 <script> 和 <style> 元素。'auto' 将对预渲染的页面使用哈希，对动态呈现的页面使用随机数。

将添加到 Content-Security-Policy 标头的指令。

将添加到 Content-Security-Policy-Report-Only 标头的指令。

是否检查传入的 origin 标头以进行 POST、PUT、PATCH 或 DELETE 表单提交，并验证它是否与服务器的来源匹配。

要允许人们从其他来源向您的应用程序发出 Content-Type 为 application/x-www-form-urlencoded、multipart/form-data 或 text/plain 的 POST、PUT、PATCH 或 DELETE 请求，您需要禁用此选项。小心！

搜索 .env 文件的目录。

一个前缀，表示环境变量可以安全地公开给客户端代码。请参阅 $env/static/public 和 $env/dynamic/public。请注意，如果你正在使用 Vite 的环境变量处理，那么 Vite 的 envPrefix 必须单独设置 - 尽管通常不需要使用该功能。

一个前缀，表示环境变量不安全，不能公开给客户端代码。既不匹配公共前缀也不匹配私有前缀的环境变量将被完全丢弃。请参阅 $env/static/private 和 $env/dynamic/private。

放置应该具有稳定 URL 且不经过任何处理的静态文件的位置，例如 favicon.ico 或 manifest.json

应用程序的内部库，可以在整个代码库中作为 $lib 访问

包含 参数匹配器 的目录

定义应用程序结构的文件（请参阅 路由）

服务工作程序入口点的位置（请参阅 服务工作程序）

HTML 响应模板的位置

后备错误响应模板的位置

SvelteKit 将预加载初始页面所需的 JavaScript 模块，以避免导入“瀑布”，从而实现更快的应用程序启动。有三种策略，各有不同的权衡

• modulepreload - 使用 <link rel="modulepreload">。这在基于 Chromium 的浏览器、Firefox 115+ 和 Safari 17+ 中提供了最佳结果。它在较旧的浏览器中被忽略。
• preload-js - 使用 <link rel="preload">。防止 Chromium 和 Safari 中出现瀑布，但 Chromium 会将每个模块解析两次（一次作为脚本，一次作为模块）。导致模块在 Firefox 中被请求两次。如果您希望以牺牲 Chromium 用户的轻微性能下降为代价，最大程度地提高 iOS 设备上用户的性能，则这是一个不错的设置。
• preload-mjs - 使用 <link rel="preload"> 但使用 .mjs 扩展名，这可以防止在 Chromium 中进行双重解析。一些静态 Web 服务器将无法使用 Content-Type: application/javascript 标头提供 .mjs 文件，这会导致您的应用程序崩溃。如果这不适用于您，则在 modulepreload 得到更广泛支持之前，此选项将为最多用户提供最佳性能。

你的应用文件提供服务的绝对路径。如果你的文件从某种存储桶提供服务，这会很有用。

必须以 / 开头但不能以 / 结尾的根相对路径（例如 /base-path），除非它为空字符串。这指定你的应用提供服务的位置，并允许应用驻留在非根路径上。请注意，你需要用基本值作为前缀添加所有根相对链接，否则它们将指向你的域的根，而不是你的 base（这是浏览器的运作方式）。你可以使用 $app/paths 中的 base：<a href="{base}/your-page">Link</a>。如果你发现自己经常写这个，那么将它提取到一个可重用组件中可能是有意义的。

是否使用相对资产路径。

如果为 true，在服务器端渲染期间，从 $app/paths 导入的 base 和 assets 将被替换为相对资产路径，从而产生更可移植的 HTML。如果为 false，则 %sveltekit.assets% 和对构建工件的引用将始终是根相对路径，除非 paths.assets 是一个外部 URL

单页面应用 回退页面将始终使用绝对路径，无论此设置如何。

如果你的应用使用 <base> 元素，你应该将此设置为 false，否则资产 URL 将错误地针对 <base> URL 而不是当前页面进行解析。

在 1.0 中，undefined 是一个有效值，它默认设置。在这种情况下，如果 paths.assets 不是外部的，SvelteKit 将用相对路径替换 %sveltekit.assets%，并使用相对路径引用构建工件，但从 $app/paths 导入的 base 和 assets 将如你的配置中指定的那样。

可以同时预渲染多少个页面。JS 是单线程的，但在预渲染性能受网络限制的情况下（例如从远程 CMS 加载内容），这可以通过在等待网络响应时处理其他任务来加快速度。

SvelteKit 是否应通过关注来自 entries 的链接来查找要预渲染的页面。

预渲染或开始爬取的页面数组（如果 crawl: true）。* 字符串包含所有不包含必需 [parameters] 的路由，其中可选参数包含为空（因为 SvelteKit 不知道任何参数应具有的值）。

如何响应在预渲染应用时遇到的 HTTP 错误。

• 'fail' — 构建失败
• 'ignore' - 静默忽略失败并继续
• 'warn' — 继续，但打印警告
• (details) => void — 一个自定义错误处理程序，它采用一个具有 status、path、referrer、referenceType 和 message 属性的 details 对象。如果从该函数中 throw，则构建将失败

ts
/** @type {import('@sveltejs/kit').Config} */
const config = {
	kit: {
		prerender: {
			handleHttpError: ({ path, referrer, message }) => {
				// ignore deliberate link to shiny 404 page
				if (path === '/not-found' && referrer === '/blog/how-we-built-our-404-page') {
					return;
				}

				// otherwise fail the build
				throw new Error(message);
			}
		}
	}
};

如何响应来自一个预渲染页面到另一个预渲染页面的哈希链接与目标页面上的 id 不对应的情况。

• 'fail' — 构建失败
• 'ignore' - 静默忽略失败并继续
• 'warn' — 继续，但打印警告
• (details) => void — 一个自定义错误处理程序，它采用一个具有 path、id、referrers 和 message 属性的 details 对象。如果从该函数中 throw，则构建将失败

如何响应由 entries 导出生成的条目与从中生成的路由不匹配的情况。

• 'fail' — 构建失败
• 'ignore' - 静默忽略失败并继续
• 'warn' — 继续，但打印警告
• (details) => void — 一个自定义错误处理程序，它采用一个具有 generatedFromId、entry、matchedId 和 message 属性的 details 对象。如果从该函数中 throw，则构建将失败

预渲染期间 url.origin 的值；如果包含在呈现的内容中，则很有用。

如果存在，是否自动注册服务工作程序。

确定 static 目录中的哪些文件将在 $service-worker.files 中可用。

一个允许你编辑生成的 tsconfig.json 的函数。你可以改变配置（推荐）或返回一个新的。这对于扩展单一代码库根目录中的共享 tsconfig.json 很有用，例如。

当前应用版本字符串。如果指定，这必须是确定性的（例如提交引用，而不是 Math.random() 或 Date.now().toString()），否则默认为构建的时间戳。

例如，要使用当前提交哈希，你可以使用 git rev-parse HEAD

ts
import * as child_process from 'node:child_process';

export default {
	kit: {
		version: {
			name: child_process.execSync('git rev-parse HEAD').toString().trim()
		}
	}
};

轮询版本更改的毫秒间隔。如果这是 0，则不会进行轮询。