Nuxt3学习笔记(二) 使用nuxi搭建一个Nuxt3项目

前言

身为前端工程师开发网页,代码编辑器肯定必不可少,在这个系列将会使用 VS Code 进行开发,不过呢,也并没有说一定非得使用 VS Code,所以说不论你是 Vim 派、VS Code 抑或是使用 WebStorm,自己用的顺手最重要。接下来我将带你开始建立 Nuxt 3 的项目。

只是玩玩而已啦

如果你还在观望还不想安装相关工具与环境,那么可以点击下面其一链接,在 StackBlitza 或 CodeSandbox 的线上编辑器环境稍微玩玩,直接线上体验 Nuxt 3。

Play on StackBlitz

Play on CodeSandbox


开始建立第一个项目

前提条件

开始之前,依照 Nuxt 3 官网的起手式我们有几个项目需要做一下检查,我们这里仅先注意一下 Node.js 的版本,建议使用目前最新 LTS 版本 v16.17.0 (包含 NPM v8.15.0)。

使用 nuxi 建立 Nuxt 3 项目

nuxi 全名为 Nuxt Command Line Interface,是由 Nuxt 提供开发的标准工具,Nuxt CLI 就像是 Vue CLI 可以建立 Vue 项目,我们当然也就可以使用 Nuxt CLI 来建立 Nuxt 的项目。

首先,打开终端机 (Terminal),将目录切换至自己习惯的工作区,接着输入如下的 nuxi 提供指令并执行,来初始化建立一个 Nuxt 3 专案。在此,我们的专案名为 nuxt-app。

npx nuxi init nuxt-app

如下图,npx 会询问你是否安装最新版本的套件 nuxi@3.0.0-rc.10 输入 y 即可。


执行完命令后直到出现如下提示,说明项目已经初始建立成功,完成后可以发现目前目录下多了一个名为 nuxt-app 的文件夹,这个文件夹也就是 Nuxt 3 项目的根目录。


接下来,我们可以进入项目目录 nuxt-app。

在 nuxt-app 目录下可以看到熟悉的 package.json,我们就可以开始安装 Nuxt 3 的相关依赖。

Nuxt CLI 如同 Vue CLI 已经在建立时帮我们初始完成许多事情,再安装完相关依赖后输入下列命令,我们就可以在开发环境下启动 Nuxt 了。

如果没有意外,可以看到 Nitro 帮我们启动了 Nuxt 3 的服务。


根据提示,我们可以在浏览器输入网址 http://localhost:3000/ 看看服务是否正常运作。

如果看到如下图的欢迎画面,恭喜你!我们已经成功建立第一个 Nuxt 3 项目咯!


现在你可以尝试打开在项目目录下的 app.vue 文件之中,app.vue 是我们 Nuxt 项目的入口,它的内容如下:


可以发现它与 Vue 3 的单一文件 (Single File Component, SFC) 相比,好像少了点什么,怎么有用了 <NuxtWelcome /> 却没看见在哪里 import 的呢?

其实呢,<NuxtWelcome /> 这个元件就是我们前面浏览器看到的欢迎画面,是 Nuxt 框架自带的一个组件,而且 Nuxt 自动导入元件的更是其特色之一,后面的系列我们会再提到自动导入 (Auto Imports)。

在这里直接移除 <NuxtWelcome /> 就可以了,我们将 app.vue 调整如下,并保存文件。 


可以看见因为 Nuxt 预设 Vite 构建并且支持HMR (Hot Module Replacement),我们可以在浏览器快速的看见修改后的结果。

至此,大家就可以先简单的玩玩 Nuxt 3,接下来我将补充一些 nuxi 的指令与参数简介。

Nuxt CLI 常用指令

以下将简单介绍一些常用的命令,如果你在项目目录下记得使用 npx 来执行 nuxi。

另外在此提醒,下面所列的指令部分参数会进行省略,若有兴趣翻翻完整的指令与参数说明,可以参考 Nuxt 3 官方文件

nuxi init


这个 nuxi init 指令是用来初始化一个 Nuxt 项目,等价 nuxi create 指令,dir 你可以填写文字作为项目与文件夹名称,也可以填写完整路径来建立项目目录。

nuxi dev

当我们在本地端进行开发时,需要运行开发环境,当我们执行 npm run dev -- -o 时,依据 package.json 中的 scripts 所列,其实就是在执行 nuxi dev -o,其中的 -o 表示服务启动后开启浏览器。

如果启动服务发现 Port 冲突,你也可以通过 -p 来将预设的监听的 Port: 3000 调整为其他数值。

e.g. nuxi dev -p 3001 或 npm run dev -- -o -p 3001

nuxi cleanup

nuxi cleanup 等价 nuxi create 指令,用来删除 Nuxt 自动产生的文件和缓存包括:

.nuxt

.output

node_modules/.vite

node_modules/.cache

nuxi upgrade

这个命令可以用来将目前项目的 Nuxt 3 升级至最新的版本,如果有一些可能行为调整或不相容的情况,可以再依据实际情境搭配 -f 参数来强制更新。

如下图,只要一行指令 npx nuxi upgrade 就可以将项目版本由 3.0.0-rc.9 升级至 3.0.0-rc.10,在 RC 阶段或之后想定期升级版本来说非常好用,但也请记得升级前可以先看一下官方的 Changelog。


小结

这篇主要介绍了如何建立 Nuxt 3 项目与 Nuxt CLI 常用指令,所谓「工欲善其事,必先利其器」,在我们开始深入介绍 Nuxt 3 前,会先带领大家把环境搭建完善,虽然接下来需要多花一点篇幅来介绍配置,但是这些配置都将有利于开发 Nuxt 。

感谢大家的阅读,也欢迎大家给予建议 :)

如果对这个 Nuxt 3 系列感兴趣,可以关注一下小编,也欢迎分享给喜欢或正在学习 Nuxt 3 的伙伴。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,470评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,393评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,577评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,176评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,189评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,155评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,041评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,903评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,319评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,539评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,703评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,417评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,013评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,664评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,818评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,711评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,601评论 2 353