TSone CLI

指南

配置

在项目根目录创建可选的 tsone.config.ts。配置文件只支持普通对象默认导出；不支持函数式或函数值配置。defineConfig() 提供类型检查而不改变对象本身。

import { defineConfig } from '@geektech/tsone-cli';

export default defineConfig({
  server: {
    proxy: {
      '/api': {
        target: 'http://localhost:3000',
        changeOrigin: true,
        rewrite: (path) => path.replace(/^\/api/, ''),
      },
    },
  },
  build: { outDir: 'dist' },
});

默认值

配置默认值
名称签名说明
entry'src/main.ts'根页面入口文件。
pages{}无额外页面。
server.host'127.0.0.1'开发服务器监听地址。
server.port52211开发服务器端口。
server.proxy{}无代理规则。
build.outDir'dist'构建输出目录。

多页应用

用 pages 选项为每条路由映射一个页面入口。路由键必须以 / 开头且可嵌套；结尾斜杠被归一化。根路由 / 不能在 pages 中重新定义——用 entry 表示它。

import { defineConfig } from '@geektech/tsone-cli';

export default defineConfig({
  entry: 'src/main.ts',
  pages: {
    '/about': 'src/about.ts',
    '/docs/guide': 'src/guide.ts',
  },
});

CLI 覆盖

命令行选项覆盖配置文件：dev 的 --host、--port、--no-watch 与 build 的 --out-dir。分离与等号写法均可。