# 开发服务
在一个 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)