01-基础配置

基础配置

完整配置选项、环境变量

---

📋 学习目标

• ✅ 掌握 ESBuild 的完整配置选项
• ✅ 理解环境变量配置
• ✅ 了解配置文件的使用
• ✅ 掌握不同环境的配置策略

---

完整配置选项

基础配置

require('esbuild').build({
  // 入口
  entryPoints: ['src/index.js'],
  
  // 输出
  bundle: true,
  outfile: 'dist/bundle.js',
  // 或
  outdir: 'dist',
  
  // 格式和平台
  format: 'esm',
  platform: 'browser',
  target: 'es2020',
  
  // 压缩
  minify: true,
  
  // Source Map
  sourcemap: true,
  
  // 代码分割
  splitting: true,
  
  // 插件
  plugins: []
})

---

环境变量

使用环境变量

const isProduction = process.env.NODE_ENV === 'production'
 
require('esbuild').build({
  minify: isProduction,
  sourcemap: !isProduction
})

注入环境变量

{
  define: {
    'process.env.NODE_ENV': '"production"',
    'process.env.API_URL': '"https://api.example.com"'
  }
}

---

配置文件

JavaScript 配置

esbuild.config.js：

module.exports = {
  entryPoints: ['src/index.js'],
  bundle: true,
  outfile: 'dist/bundle.js'
}

TypeScript 配置

esbuild.config.ts：

import { BuildOptions } from 'esbuild'
 
const config: BuildOptions = {
  entryPoints: ['src/index.ts'],
  bundle: true,
  outfile: 'dist/bundle.js'
}
 
export default config

---

相关链接

• ESBuild API 文档
• ESBuild MOC

---

最后更新：2025

---

ESBuild 配置