跳到主要内容

next.config.js

Next.js可以通过项目目录根目录中的 next.config.js 文件进行项目配置。

assetPrefix​

用于配置静态资源的前缀。

const isProd = process.env.NODE_ENV === 'production'
 
module.exports = {
  assetPrefix: isProd ? 'https://cdn.mydomain.com' : undefined,
}

basePath​

用于配置部署项目的前缀。

module.exports = {
  basePath: '/docs',
}

compress​

当使用next start启动项目时，默认会开启gzip压缩。

module.exports = {
  compress: true
}

distDir​

用于配置编译后的文件输出目录。

module.exports = {
  distDir: 'dist',
}

eslint​

module.exports = {
  eslint: {
    ignoreDuringBuilds: true, // 忽略在构建时出现的错误
  }
}

generateEtags​

用于配置是否生成ETag, 默认是开启的。

module.exports = {
  generateEtags: true,
}

output​

用于配置编译后的文件输出类型, 默认是standalone表示使用next.js的内嵌式运行时; export表示生成静态化文件，然后通过nginx等服务进行静态化文件的部署。

module.exports = {
  output: 'standalone | export',
}

typescript​

用于配置typescript的编译。

module.exports = {
    typescript: {
        ignoreBuildErrors: true // 忽略ts构建错误
    },
}