Surfboard 是一个用于前端开发的工具，类似于 webpack，它可以帮助你更高效地构建和优化前端应用。以下是 Surfboard 的基本配置教程

原子VPN 2026-10-08 多平台网络连接翻墙工具 0 1

安装 Surfboard

你需要安装 Surfboard，如果你还没有安装,可以通过以下命令安装：

npm install surfboard

或者使用 Yarn：

yarn add surfboard

初始化 Surfboard

安装完成后，你需要初始化 Surfboard,在项目根目录下运行以下命令：

surfboard init

这会在项目根目录下创建一个 config/surfboard.js 文件,里面包含初始配置。

配置 Surfboard

编辑 config/surfboard.js 文件,配置文件内容如下：

module.exports = {
  input: 'src', // 输入文件夹，默认为 'src'
  output: 'dist', // 输出文件夹，默认为 'dist'
  devServer: {
    port: 300, // 开发服务器的端口，默认为 300
    host: 'localhost', // 开发服务器的主机，默认为 'localhost'
    hot: true, // 启用热重载，默认为 true
  },
  paths: {
    assets: 'src/assets', // 资源文件路径，默认为 'src/assets'
    components: 'src/components', // 组件路径，默认为 'src/components'
  },
}

使用 Surfboard

在项目根目录下运行以下命令构建项目：

surfboard build

这会将输入文件夹中的文件打包到输出文件夹中，打包完成后，文件会出现在 dist 文件夹中。

测试开发服务器

如果你启用了开发服务器,你可以在命令行运行以下命令启动开发服务器：

surfboard serve

这会启动一个 development 服务器，自动刷新页面,并在文件修改时自动重新打包和加载。

配置 webpack

Surfboard 基于 webpack，所以你可以在 webpack.config.js 中添加 Surfboard 的 loader 和 plugin。

module.exports = {
  entry: './src/index.js',
  output: {
    filename: 'index.js',
    library: 'MySurfboardApp',
    libraryTarget: 'umd',
    globalObject: 'this',
  },
  module: {
    rules: [
      {
        test: /\.js$/,
        exclude: /node_modules/,
        use: {
          loader: 'surfboard-loader',
        },
      },
    ],
  },
}

自定义路径别名

在 config/surfboard.js 中的 paths 部分,你可以自定义路径别名：

paths: {
  assets: 'src/assets', // 资源文件路径，默认为 'src/assets'
  components: 'src/components', // 组件路径，默认为 'src/components'
  api: 'src/api', // API 文件路径，默认为 'src/api'
},

这样你可以在代码中引用路径别名：

import MyComponent from '@/components/MyComponent';

常见问题

问题：配置文件不存在

如果你没有运行 surfboard init，Surfboard 会自动创建配置文件，如果配置文件丢失，可以重新运行 surfboard init。
问题：打包失败

如果打包过程中遇到问题，检查 config/surfboard.js 是否配置正确,特别是路径和输出文件夹是否正确。
问题：无法启动开发服务器

确保你已经安装了 http-server 或其他开发服务器工具，或者配置了正确的 devServer 参数。

进阶配置

优化打包

配置 webpack 的 optimizeOption：

module.exports = {
  optimize: {
    runtime: true,
    sideEffects: true,
  },
}

添加新 loader

在 webpack.config.js 中添加新的 loader：

module.exports = {
  module: {
    rules: [
      {
        test: /\.txt$/,
        use: {
          loader: 'surfer-loader',
        },
      },
    ],
  },
}