如何为现有Svelte项目正确添加Sapper并解决导入报错问题
现有Svelte项目接入Sapper操作指南
该操作完全可行,你当前遇到的安装报错、导入失败问题,根源是初始依赖安装方式错误。Sapper是带固定目录结构的全栈Svelte框架,不能直接挂载在现有纯客户端SPA项目上,需要按规则调整项目结构和构建配置。
核心问题纠正
你执行的npm i @sapper操作完全无效:
@sapper是npm组织的scope标识,不是可独立安装的包名,不存在这个实体包- Sapper的所有功能模块都是独立发布的,需要分别安装对应依赖
- 你写的导入语句
import { goto } from '@sapper/app'本身没有语法问题,报错是因为你根本没有安装@sapper/app这个独立依赖包
具体接入步骤
1. 正确安装依赖
先删除之前错误安装的@sapper包,再执行安装命令:
npm install --save-dev @sapper/sapper @sapper/app @sapper/server
如果需要支持静态站点导出功能,可以额外安装@sapper/export包。
2. 调整项目目录结构
Sapper有固定的结构要求,现有业务代码可直接复用,不需要重写:
- 新建
src/routes目录,把原src/views下的所有页面组件迁移到该目录,Sapper会自动基于文件路径生成路由规则 - 新建
src/client.js作为客户端入口,替代现有src/main.js,核心逻辑是调用Sapper的客户端挂载方法 - 新建
src/server.js作为服务端入口,项目里已安装的express、polka依赖可以直接复用,用来配置服务端中间件 - 新建
src/template.html作为全局HTML模板,替代现有public/index.html - 现有
src/components、src/assets目录,以及自定义的路径别名配置可以完全保留,不需要修改 - 把原
public目录下的纯静态资源(编译后的Tailwind文件、FontAwesome资源等)迁移到新建的static目录,Sapper会自动把该目录下的文件拷贝到最终构建产物中
3. 替换构建配置
现有Rollup配置是纯静态SPA的打包逻辑,完全不兼容Sapper的多端构建要求,需要做如下调整:
- 移除现有配置里的纯客户端逻辑:包括输出格式为
iife的规则、自定义的serve函数、livereload插件、直接输出到public/build/bundle.js的配置 - 调整打包入口为Sapper要求的三个入口:客户端入口、服务端入口、服务端渲染入口
- 现有的svelte插件配置、路径别名配置、SCSS处理、Tailwind相关构建逻辑可以全部保留,只需要调整输出路径适配Sapper的构建规则即可
4. 适配内置路由
接入Sapper后,可以直接移除现有项目使用的svelte-routing库,替换为Sapper内置的路由能力:
- 原有页面跳转逻辑中,将原来的路由Link组件替换为普通a标签,Sapper会自动拦截链接跳转,实现客户端路由切换
- 编程式跳转直接使用Sapper内置的
goto方法,也就是你之前写的导入语句,依赖安装完成后即可正常运行
脚本配置调整
替换现有package.json中的启动、构建脚本:
- 开发环境启动脚本:
sapper dev - 生产构建脚本:
sapper build - 生产环境启动脚本:
node __sapper__/build
兼容性说明
当前项目使用的Svelte 3.x版本、Rollup 2.x版本,完全兼容Sapper稳定版的版本要求,不需要升级现有依赖版本。
内容的提问来源于stack exchange,提问作者svelteDev
相关产品推荐
相关产品推荐

