请通过邮件订阅网站,随时获取最新动态!

# 开发服务

在一个 Next CLI 项目中,@startdt/cli-service 会安装一个名为 next-cli-service 的命令。

提示

你可以通过 next ui 命令使用 GUI 运行更多的特性脚本。

# 使用命令

如果你使用默认预设创建项目,会生成以下 package.json 配置:

{
    "scripts": {
        "serve": "next-cli-service serve",
        "build": "next-cli-service build"
    }
}

你可以通过 npm 或 Yarn 调用这些 script 命令:

npm run serve
# 或者
yarn serve

# 开发服务

next-cli-service serve 命令会启动一个开发服务器并附带开箱即用的模块热重载。

用法:next-cli-service serve [options] [entry]

选项:
    --open    在服务器启动时打开浏览器
    --copy    将本地 URL 复制到剪切板
    --mode    指定环境模式(默认值:development)
    --host    指定 host(默认值:0.0.0.0)
    --port    指定 port(默认值:8080)
    --https   使用 https(默认值:false)

除了通过命令行参数,你也可以使用 next.config.js 里的 devServer 字段配置开发服务器。

# 生产构建

next-cli-service build 会在输出目录产生一个可用于生产环境的包,带有 JS/CSS/HTML 的压缩,和为更好的缓存而做的自动的 vendor chunk splitting。它的 chunk manifest 会内联在 HTML 里。

用法:next-cli-service build [options] [entry|pattern]

选项:
    --mode        指定环境模式(默认值:production)
    --dest        指定输出目录(默认值:dist)
    --modern      面向现代浏览器带自动回退地构建应用
    --target      指定构建目标(app | lib | wc | wc-async,默认值:app)
    --name        库的名称或 Web Components 组件的名称(默认值:package.json 中的 "name" 字段或入口文件名)
    --no-clean    在构建项目之前不清除目标目录
    --report      生成 report.html 以帮助分析包内容
    --report-json 生成 report.json 以帮助分析包内容
    --watch       监听文件变化

# 审查配置

你可以使用 next-cli-service inspect 来审查一个 Next CLI 项目的 webpack 配置。

用法:next-cli-service inspect [options] [...paths]

选项:
    --mode    指定环境模式(默认值:development)