简体中文

server.publicDir

type PublicDir =
  | false
  | {
      name?: string;
      copyOnBuild?: boolean;
      watch?: boolean;
    };

const defaultValue = {
  name: 'public',
  copyOnBuild: true,
  watch: false,
};

默认情况下，Rsbuild 会将 public 目录作为静态资源服务的文件夹，该目录中的文件可在 / 路径下访问。

相关文档：public 目录。

选项

public 目录名称。name 的值可以设置为相对路径或绝对路径，相对路径将会相对于项目根目录进行解析。

export default {
  server: {
    publicDir: {
      name: '../some-public',
    },
  },
};

import path from 'node:path';

export default {
  server: {
    publicDir: {
      name: path.join(__dirname, '../some-public'),
    },
  },
};

在生产构建时，是否将文件从 public 目录复制到构建产物目录。

比如关闭 copyOnBuild：

export default {
  server: {
    publicDir: {
      copyOnBuild: false,
    },
  },
};

需要注意的是，将 copyOnBuild 的值为 false 后，如果执行 rsbuild preview 进行生产环境预览，将无法访问对应的静态资源文件。

TIP

在 dev 构建时，如果你需要拷贝一些静态资源到构建产物目录，可以使用 output.copy 选项代替。

是否监听 public 目录，并在文件发生变化时重新加载页面。

设置 watch 为 true 后，开发环境下会监控指定公共目录下的文件变化，并在文件发生变化时重新加载页面：

export default {
  server: {
    publicDir: {
      watch: true,
    },
  },
};

需要注意的是，watch 选项仅在开发环境下有效。如果 dev.hmr 和 dev.liveReload 都设置为 false，则 watch 将被忽略。

你可以将 publicDir 设置成 false 来禁用静态资源服务：

export default {
  server: {
    publicDir: false,
  },
};