配置参考

Nasti 使用 nasti.config.ts（或 .js / .mjs）作为配置文件。

完整配置示例

import { defineConfig } from 'nasti-build'

export default defineConfig({
  root: '.',
  base: '/',
  mode: 'development',
  framework: 'react',
  logLevel: 'info',
  envPrefix: ['NASTI_', 'VITE_'],

  resolve: {
    alias: { '@': '/src' },
    extensions: ['.ts', '.tsx', '.js', '.jsx'],
  },

  server: {
    port: 3000,
    host: true,
    open: true,
    cors: true,
    hmr: true,
  },

  build: {
    outDir: 'dist',
    assetsDir: 'assets',
    sourcemap: true,
    minify: true,
    emptyOutDir: true,
    target: 'es2022',
  },

  plugins: [],
})

通用选项

选项	类型	默认值	说明
`root`	`string`	`'.'`	项目根目录
`base`	`string`	`'/'`	公共基础路径
`mode`	`string`	`'development'`	运行模式
`framework`	`'react' \| 'vue' \| 'auto'`	`'auto'`	框架类型
`logLevel`	`'info' \| 'warn' \| 'error' \| 'silent'`	`'info'`	日志级别
`envPrefix`	`string \| string[]`	`['NASTI_', 'VITE_']`	暴露给客户端的环境变量前缀
`plugins`	`NastiPlugin[]`	`[]`	插件列表

resolve 选项

选项	类型	默认值	说明
`alias`	`Record<string, string>`	`{}`	路径别名
`extensions`	`string[]`	`['.ts', '.tsx', ...]`	导入时省略的扩展名
`conditions`	`string[]`	`['import', 'module', ...]`	package.json exports 条件
`mainFields`	`string[]`	`['module', 'main']`	package.json 入口字段

server 选项

选项	类型	默认值	说明
`port`	`number`	`3000`	端口号
`host`	`string \| boolean`	`'localhost'`	监听地址，`true` 表示 `0.0.0.0`
`https`	`boolean`	`false`	是否启用 HTTPS
`open`	`boolean \| string`	`false`	自动打开浏览器
`cors`	`boolean`	`true`	是否启用 CORS
`hmr`	`boolean \| HmrConfig`	`true`	HMR 配置

build 选项

选项	类型	默认值	说明
`outDir`	`string`	`'dist'`	输出目录
`assetsDir`	`string`	`'assets'`	资源子目录
`minify`	`boolean`	`true`	是否压缩
`sourcemap`	`boolean \| 'inline' \| 'hidden'`	`false`	Source map
`target`	`string`	`'es2022'`	构建目标
`emptyOutDir`	`boolean`	`true`	构建前清空输出目录
`rolldownOptions`	`object`	`{}`	传递给 Rolldown 的额外选项