SvelteKit bundleStrategy:'inline'未生成单文件问题求助

开发者阿泽

2026-6-14

问题排查方案

以下是几种可能导致bundleStrategy: 'inline'配置未生效的原因及解决方法：

1. 配置放置位置错误

bundleStrategy是SvelteKit的专属配置，必须放在svelte.config.js的kit.output字段下，而非vite.config.js中。正确的配置示例：

import adapter from '@sveltejs/adapter-static';

/** @type {import('@sveltejs/kit').Config} */
const config = {
	kit: {
		adapter: adapter(),
		output: {
			bundleStrategy: 'inline'
		}
	}
};

export default config;

如果误将该配置放在vite.config.js里，SvelteKit不会读取这个设置，自然无法生成单文件产物。

2. 使用的Adapter不兼容

并非所有SvelteKit适配器都支持bundleStrategy: 'inline'，比如adapter-node这类面向服务端运行的适配器就不支持该特性。你需要切换到支持静态输出的适配器，比如@sveltejs/adapter-static，这是实现单文件打包的前提。

3. 存在未被内联的动态资源

如果项目中包含以下内容，可能导致部分资源仍保留在_app目录：

动态import()语句：SvelteKit无法内联动态加载的代码块，这类代码会被单独打包。
大体积资源：默认情况下，超过一定大小（通常为4KB）的图片、字体等资源会被单独输出，而非内联到HTML中。你可以在vite.config.js中调整assetInlineLimit参数，扩大内联资源的体积阈值：

import { sveltekit } from '@sveltejs/kit/vite';

/** @type {import('vite').UserConfig} */
const config = {
	plugins: [sveltekit()],
	build: {
		rollupOptions: {
			output: {
				assetInlineLimit: 1024 * 10 // 设置为10KB
			}
		}
	}
};

export default config;