SvelteKit项目build文件夹移出项目目录后无法运行的问题

问题原因 #

核心问题源于Node.js的模块识别规则：

• 在项目根目录运行时，Node会读取根目录的package.json，如果其中配置了"type": "module"，Node会将所有.js文件当作ES模块处理，自然支持import语法。
• 当把build文件夹单独移到桌面后，该文件夹下没有自己的package.json，Node默认会将.js文件当作CommonJS模块处理，此时遇到import语句就会抛出语法错误。

SvelteKit的build产物本身包含完整运行逻辑，但它依赖Node的模块类型配置——这个配置默认从父目录的package.json继承，移出后就丢失了关键的模块类型声明。

解决方案 #

方案1：在build文件夹中添加package.json #

在build文件夹根目录创建一个package.json文件，仅需指定模块类型：

{
  "type": "module"
}

之后执行node index.js即可正常运行。

方案2：启动时指定模块类型参数 #

无需额外创建文件，直接在启动命令中添加参数强制Node以ES模块模式处理入口文件：

node --input-type=module index.js

方案3：调整SvelteKit构建配置（可选） #

如果希望构建产物默认兼容CommonJS环境，可以修改velte.config.js，将输出格式设置为CommonJS：

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

export default {
  kit: {
    adapter: adapter({
      out: 'build',
      format: 'cjs' // 指定输出为CommonJS格式
    })
  }
};

修改后重新执行npm run build，构建产物会自动使用require语法，无需额外配置即可在任意目录运行。

内容的提问来源于stack exchange，提问作者Elshad Shabanov