构建工具配置(以Vite为例)
- 安装依赖:
- 安装
@sveltejs/kit
,它是Svelte进行SSR的核心工具。运行npm install @sveltejs/kit
。
- 配置
vite.config.js
:
import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig } from 'vite';
export default defineConfig({
plugins: [sveltekit()]
});
- 此配置启用了SvelteKit插件,它会处理Svelte组件的编译以及SSR相关的构建。
服务器设置
- 项目结构:
- 在项目根目录下创建
src/routes
目录,这是SvelteKit约定的路由目录。
- 例如,创建
src/routes/index.svelte
文件,该文件将作为应用的首页。
- 服务器启动脚本:
- 如果使用默认的SvelteKit设置,运行
npm run dev
即可在开发模式下启动带有SSR功能的服务器。
- 对于生产环境,运行
npm run build
进行构建,构建后的文件位于build
目录。然后可以使用如@sveltejs/adapter-auto
等适配器,将构建后的应用部署到不同的目标平台(如Node.js服务器、静态托管等)。例如,对于Node.js服务器部署:
- 安装
@sveltejs/adapter-node
:npm install @sveltejs/adapter-node
。
- 在
svelte.config.js
中配置适配器:
import adapter from '@sveltejs/adapter-node';
export default {
kit: {
adapter: adapter()
}
};
- 构建后,在
build
目录中会生成可在Node.js环境中运行的文件,通过node build/index.js
启动生产服务器。
环境变量配置
- 创建
.env
文件:
- 在项目根目录下创建
.env
文件,用于存储敏感信息或特定环境的配置。例如,可以定义NODE_ENV
等变量。
- 注意在生产环境中,这些变量可能需要通过服务器的环境变量设置来配置,而不是直接硬编码在
.env
文件中。
其他配置
- 页面元数据与SEO:
- 在页面组件(如
index.svelte
)中,可以使用SvelteKit提供的方式设置页面元数据,以优化SEO。例如:
<script context="module">
export const metadata = {
title: 'My Svelte SSR App',
description: 'An app with server - side rendering'
};
</script>