# macOS / Linux
curl -fsSL https://bun.sh/install | bash
 
# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"
 
# 通过 npm
npm install -g bun
 
# 验证安装
bun --version

# 基础打包
bun build ./src/index.ts --outdir ./dist
 
# 生产构建（启用压缩 + NODE_ENV=production）
bun build ./src/index.ts --outdir ./dist --production
 
# 指定目标
bun build ./src/index.ts --target=browser --outdir ./dist
 
# 监听模式
bun build ./src/index.ts --outdir ./dist --watch
 
# 编译为单文件可执行程序
bun build ./src/cli.ts --outfile mycli --compile

const result = await Bun.build({
  entrypoints: ['./src/index.tsx'],
  outdir: './dist',
  target: 'browser',
  format: 'esm',
  splitting: true,
  minify: true,
  sourcemap: 'external',
});
 
if (!result.success) {
  console.error(result.logs);
  process.exit(1);
}

// src/greet.ts
export function greet(name: string): string {
  return `Hello, ${name}!`;
}
 
// src/index.ts
import { greet } from './greet';
console.log(greet('Bun'));

bun build ./src/index.ts --outdir ./dist --production
# 输出: dist/index.js (压缩后的单文件)

const result = await Bun.build({ entrypoints: ['./app.ts'] });
// 直接作为 HTTP 响应返回
return new Response(result.outputs[0], {
  headers: { 'Content-Type': 'application/javascript' },
});

import homepage from './index.html';
 
Bun.serve({
  routes: { '/': homepage },
  development: true,
});

import { feature } from 'bun:bundle';
 
if (feature('PREMIUM')) {
  initPremiumFeatures(); // 当 PREMIUM 未启用时，整段代码被移除
}

bun build ./cli.ts --outfile mycli --compile

await Bun.build({
  entrypoints: ['./app.ts'],
  target: 'bun',
  bytecode: true,
  compile: true,
});

await Bun.build({
  entrypoints: ['/app/index.ts'],
  files: {
    '/app/index.ts': `import { greet } from './greet.ts'; console.log(greet('World'));`,
    '/app/greet.ts': `export function greet(name) { return 'Hello, ' + name; }`,
  },
});

minify: {
  whitespace: true,   // 压缩空白
  identifiers: true,  // 缩短标识符
  syntax: true,       // 语法优化
}

bun build ./src/index.ts --outdir ./dist --metafile ./dist/meta.json --metafile-md ./dist/meta.md

// Tailwind CSS 插件
// bunfig.toml
[serve.static]
plugins = ["bun-plugin-tailwind"]

bun add bun-plugin-tailwind tailwindcss

const myPlugin: BunPlugin = {
  name: 'custom-loader',
  setup(build) {
    build.onLoad({ filter: /\.md$/ }, async (args) => {
      const text = await Bun.file(args.path).text();
      return {
        contents: `export default ${JSON.stringify(text)};`,
        loader: 'js',
      };
    });
  },
};

// server.ts
import homepage from './index.html';
 
Bun.serve({
  routes: { '/': homepage },
  development: {
    hmr: true,      // 热模块替换
    console: true,  // 浏览器日志输出到终端
  },
});

# 预编译构建（推荐）
bun build --target=bun --production --outdir=dist ./src/index.ts
 
# 运行
NODE_ENV=production bun dist/index.js

FROM oven/bun:1 AS base
WORKDIR /app
 
FROM base AS install
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile
 
FROM base AS build
COPY --from=install /app/node_modules ./node_modules
COPY . .
RUN bun build --target=bun --production --outdir=dist ./src/index.ts
 
FROM base AS release
COPY --from=build /app/dist ./dist
EXPOSE 3000
CMD ["bun", "dist/index.js"]

# GitHub Actions 示例
name: Build & Deploy
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - run: bun install --frozen-lockfile
      - run: bun run typecheck
      - run: bun build --production --outdir=dist ./src/index.ts
      - run: bun test

await Bun.build({
  entrypoints: ['./src/page-a.ts', './src/page-b.ts'],
  splitting: true,  // 共享模块提取为独立 chunk
  outdir: './dist',
});

// 推荐：只暴露公开变量
await Bun.build({
  entrypoints: ['./src/index.ts'],
  env: 'PUBLIC_*',  // 仅内联 PUBLIC_ 前缀的变量
  outdir: './dist',
});

// 针对 antd/lodash 等重导出文件优化
await Bun.build({
  entrypoints: ['./src/index.ts'],
  optimizeImports: ['antd', '@mui/material', 'lodash-es'],
  outdir: './dist',
});

await Bun.build({
  entrypoints: ['./src/server.ts'],
  target: 'bun',
  format: 'esm',
  minify: {
    whitespace: true,
    identifiers: true,
    syntax: true,
  },
  sourcemap: 'external',
  splitting: true,
  drop: ['console', 'debugger'],
  outdir: './dist',
});

await Bun.build({
  entrypoints: [
    './src/pages/home.ts',
    './src/pages/dashboard.ts',
    './src/pages/settings.ts',
  ],
  splitting: true,
  naming: {
    entry: '[dir]/[name]-[hash].[ext]',
    chunk: 'chunks/[name]-[hash].[ext]',
  },
  outdir: './dist',
});

bun build ./src/cli.ts \
  --outfile mycli \
  --compile \
  --windows-hide-console \
  --windows-icon ./icon.ico

await Bun.build({
  entrypoints: ['./src/index.ts'],
  naming: {
    entry: '[dir]/[name]-[hash].[ext]',
    chunk: '[name]-[hash].[ext]',
    asset: 'assets/[name]-[hash].[ext]',
  },
  publicPath: 'https://cdn.example.com/',
  outdir: './dist',
});