SvelteKit 最新中文文档教程（8）—— 部署 Node 服务端

前言

Svelte，一个语法简洁、入门容易，面向未来的前端框架。

从 Svelte 诞生之初，就备受开发者的喜爱，根据统计，从 2019 年到 2024 年，连续 6 年一直是开发者最感兴趣的前端框架 No.1：

Svelte 以其独特的编译时优化机制著称，具有轻量级、高性能、易上手等特性，非常适合构建轻量级 Web 项目。

为了帮助大家学习 Svelte，我同时搭建了 Svelte 最新的中文文档站点。

如果需要进阶学习，也可以入手我的小册《Svelte 开发指南》，语法篇、实战篇、原理篇三大篇章带你系统掌握 Svelte！

欢迎围观我的“网页版朋友圈”、加入“冴羽·成长陪伴社群”，踏上“前端大佬成长之路”。

Node 服务端

要生成独立的 Node 服务端，请使用 adapter-node。

使用方法

使用 npm i -D @sveltejs/adapter-node 安装，然后将适配器添加到您的 svelte.config.js：

// @errors: 2307
/// file: svelte.config.js
import adapter from '@sveltejs/adapter-node';

export default {
   
   
	kit: {
   
   
		adapter: adapter()
	}
};

部署

首先，使用 npm run build 构建您的应用。这将在适配器选项中指定的输出目录（默认为 build）中创建生产服务端。

要运行应用程序，您需要输出目录、项目的 package.json 和 node_modules 中的生产依赖项。生产依赖项可以通过复制 package.json 和 package-lock.json 然后运行 npm ci --omit dev 来生成（如果您的应用没有任何依赖项，可以跳过此步骤）。然后您可以使用以下命令启动您的应用：

node build

开发依赖项将使用 Rollup 打包到您的应用中。要控制某个包是打包还是外部化，请将其分别放在 package.json 的 devDependencies 或 dependencies 中。

压缩响应

通常您会希望压缩来自服务端的响应。如果您已经在为 SSL 或负载均衡部署了反向代理服务端，那么在该层处理压缩通常会带来更好的性能，因为 Node.js 是单线程的。

但是，如果您正在构建自定义服务端并确实想在那里添加压缩中间件，请注意我们建议使用 @polka/compression，因为 SvelteKit 会流式传输响应，而更流行的 compression 包不支持流式传输，使用时可能会导致错误。

环境变量

在 dev 和 preview 模式下，SvelteKit 将从您的 .env 文件（或 .env.local，或 .env.[mode]，由 Vite 决定）中读取环境变量。

在生产环境中，不会自动加载 .env 文件。要做到这一点，请在您的项目中安装 dotenv…

npm install dotenv

…并在运行构建的应用之前调用它：

node +++-r dotenv/config+++ build

如果您使用的是 Node.js v20.6+，您可以使用 --env-file