一、背景介绍
2022 年 11 月 16 日,全球最大的 Nuxt 会议 Nuxt Nation 2022 在线举行,并正式发布了 Nuxt.js 3.0 的第一个稳定版本。Nuxt 3 是基于 Vite、Vue3 和 Nitro 的 Nuxt 框架的现代重写,具有一流的 Typescript 支持,是两年多研究、社区反馈、创新和实验的结果。为每个人提供了一个愉快的 Vue 全栈开发体验。
因为nuxt优越的服务端渲染能力,所以对于nuxt3项目关注已久!我们开始吧!
二、官方网址
Nuxt 3 - 中文文档
Nuxt - The Intuitive Vue Framework
Announcing 3.0 · Nuxt
Nuxt - Installation
https://github.com/nuxt/create-nuxt-app/blob/master/README.md
三、新特性介绍
1、更轻量:以现代浏览器为目标的服务器部署和客户端产物最多可缩小 75 倍
2、更快:基于 nitro 提供动态代码分割能力,以优化冷启动性能
3、Hybrid:增量静态生成和其他的高级功能现在都成为可能
4、Suspense:在任意组件和导航前后都可以获取数据
5、Composition API:使用 Composition API 和 Nuxt 3 的 composables 实现真正的代码复用
6、Nuxt CLI:没有任何依赖,帮你轻松搭建项目和集成模块
7、Nuxt Devtools:通过直接在浏览器中查看信息和快速修复实现更快地工作
8、Nuxt Kit:具有 Typescript 和跨版本兼容性的全新模块开发
9、Webpack 5:更快的构建时间和更小的包大小,无需配置
10、Vite:使用 Vite 作为打包工具,体验闪电般快速的 HMR
11、Vue 3:Vue 3 是你下一个 Web 应用程序的坚实基础
12、TypeScript:使用原生 TypeScript 和 ESM 构建,无需额外步骤
Nuxt 3.0 稳定版正式发布,基于 Vue 3 的 Web 框架
四、重要概念
SPA应用:也就是单页应用,这些多是在客户端的应用,不能进行SEO优化(搜索引擎优化)。
SSR应用:在服务端进行渲染,渲染完成后返回给客户端,每个页面有独立的URL,对SEO友好。
约定式路由:不需要配置路由,在根目录pages目录下创建业务页面,即可访问。
约定式配置:如layouts布局、middleware、plugins
五、启动基础项目
https://github.com/nuxt/create-nuxt-app/blob/master/README.md
5.1、创建项目:
创建nuxt3项目:
pnpm dlx nuxi init nuxt-app
npx nuxi init nuxt3-app
5.2、安装依赖
pnpm install --shamefully-hoist
5.3、启动项目
启动成功
六、项目配置、基础使用
6.1、访问pages/index.vue
根目录app.vue,
pages/index.vue
snow
pages/about.vue
about
这样就可以访问页面了:
6.2、动态路由
6.2.1、目录结构
6.2.2、访问:/user
如果没有pages/user/index页面,只有[id].vue,访问的时候式404页面
6.2.3、访问:/user/1,动态路由,获取动态路由参数
{{$route.params.id}}
6.2.4、访问:/user/1?name=snow,动态路由,获取路由普通参数:
{{$route.query.name}}
6.2.5、通过useRoute()获取路由信息
const route = useRoute()
user-id:{{$route.params.id}}
user-name:{{$route.query.name}}
6.3、路由跳转
经过测试一下几种方式均成功跳转。页面内容均正常展示。
6.3.1、
user-id
6.3.2、
6.3.3、
user-id-3
6.3.4、编程式路由
6.4、加载静态资源
nuxt项目tsconfig.json有配置,public目录下的文件可以省略/public目录,我这里测试不可以,后续会再研究
已测试成功,可以省略 “~/public” 目录
6.5、设置页面title,不会在页面展示,只会在页面title部分展示
6.5.1、
snow-title
snow-title
如图:
ctrl + u:
6.5.2、使用useHead()方法
useHead({
title: 'snow-title-2'
})
设置成功,useHead优先级小于
6.5.3、同理使用useHead设置页面的TDK信息
6.6、layouts
6.6.1、理解:布局、页面布局、公共布局、基础布局
6.6.2、根目录创建layouts目录,/layouts/default.vue
snow-default-layout
6.6.3、app.vue
6.6.4、
6.6.5、某页面不想使用layout:
definePageMeta({
layout: false
})
6.6.6、某页面使用指定layout
definePageMeta({
layout: 'layout-snow'
})
6.6.7、动态设置layout
const router = useRoute()
function enableLayout () {
router.meta.layout = "layout-snow"
}
6.6.8、全局设置,指定layout
6.7、plugins
/plugins/index.ts
export default defineNuxtPlugin(()=>{
return {
provide: {
hello: (msg: string) => `hello ${msg}`
}
}
})
/pages/plugin.vue
snow-plugin
6.8、middleware
/middleware/auth.ts
export default defineNuxtRouteMiddleware((to, from)=>{
console.log("auth")
})
/middleware/snow.ts
export default defineNuxtRouteMiddleware((to, from)=>{
console.log("snow")
})
/pages/plugin.vue
snow-plugin
如图:
6.9、server
6.9.1、目录
6.9.2、server/api/hello.ts
export default defineEventHandler((event) => {
return {
api: "works"
}
})
6.9.3、server/api/test.get.ts
export default defineEventHandler((event) => {
return `test get ts`
})
6.9.4、server/api/test.post.ts
export default defineEventHandler((event) => {
return `test post ts`
})
post请求需要使用postman工具:
6.9.5、 server/api/foo/[...].ts
可以带有参数
export default defineEventHandler(() => `default api handle`)
6.9.6、server/api/submit.post.ts
export default defineEventHandler (async (event) => {
const body = await readBody(event);
return { body }
})
6.9.7、server/api/query.get.ts
export default defineEventHandler((event) => {
const query = getQuery(event)
return { a: query.param1, b: query.param2 }
})
6.10、使用element-plus
6.10.1、安装
pnpm install element-plus
pnpm add sass sass-loader -D
pnpm add unplugin-auto-import unplugin-icons unplugin-vue-components -D
6.10.2、package.json
{
"private":true,
"scripts":{
"build":"nuxt build",
"dev":"nuxt dev",
"generate":"nuxt generate",
"preview":"nuxt preview",
"postinstall":"nuxt prepare"
},
"devDependencies":{
"nuxt":"3.0.0",
"sass":"1.57.1",
"sass-loader":"13.2.8",
"unplugin-auto-import":".12.1",
"unplugin-icons":".14.15",
"unplugin-vue-components":".22.12"
},
"dependencies":{
"element-plus":"^2 .2.27"
}
}
6.10.3、assets/scss/index.scss
@use "element-plus/dist/index.css";
6.10.4、tsconfig.json
{
// https://nuxt.com/docs/guide/concepts/typescript
"extends": "./.nuxt/tsconfig.json",
"compilerOptions": {
"types": ["element-plus/global"]
}
}
6.10.5、 nuxt.config.ts
import AutoImport from 'unplugin-auto-import/vite'
import Components from "unplugin-vue-components/vite";
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
import IconsResolver from "unplugin-icons/resolver";
const lifecycle = process.env.npm_lifecycle_event;
export default defineNuxtConfig({
vite: {
plugins: [
AutoImport({
resolvers: [
ElementPlusResolver(
),
IconsResolver()]
}),
Components({
dts: true,
resolvers: [ElementPlusResolver(
{
importStyle: false
}
)]
}),
],
},
components: true,
css: ["~/assets/scss/index.scss"],
transpile: ["element-plus"],
build: {
transpile: lifecycle === "build" ? ["element-plus"] : [],
},
})
6.10.6、plugins/element-plus.ts
import { ID_INJECTION_KEY } from 'element-plus';
export default defineNuxtPlugin(nuxtApp => {
// Doing something with nuxtApp
nuxtApp.vueApp.provide(ID_INJECTION_KEY,{
prefix: Math.floor(Math.random() * 10000),
current: 0,
})
})
6.10.7、pages/index.vue
ElButton
6.10.8、成功实现效果
6.11、获取数据 | Nuxt 3 - 中文文档
请求数据的方法有:useAsyncData、useLazyAsyncData (useAsyncData+lazy:true)、useFetch、useLazyFetch (useFetch+lazy:true)
pages/req.vue
snow
数据获取成功:
注:1,这里使用的全路径接口地址请求的数据,没有因为是本地开发出现跨域问题,同时没有配置代理。2、多次尝试配置代理,使用方法包括vite、nitro,均没有成功,网上暂时也没有找到明确的解答。3、如果后续有了代理相关的进展会及时更新。4、既然本地使用全路径没有跨域问题,那么我考虑在封装请求时候使用全局环境变量来拼接不同环境的域名+接口地址。
6.12、封装请求
6.12.1、utils/request.ts
import { ElMessage } from 'element-plus'
const fetch = (url: string, options?: any): Promise => {
const token = useCookie("token");
const headers = { // headers信息
'Authorization' : `Bearer ${token.value}`
}
const { public: { baseUrl } } = useRuntimeConfig()
const reqUrl = baseUrl + url
return new Promise((resolve, reject) => {
useFetch(reqUrl, { ...options, headers }).then(({ data }: any) => {
const value = data.value
if (!data._rawValue) {
// 这里处理错误回调
reject(value)
}else if(data._rawValue.code !== '0'){
ElMessage({
message: data._rawValue.msg,
type: 'error',
})
} else {
console.log('40data', data._rawValue)
resolve(ref(data))
}
}).catch((err: any) => {
reject(err)
})
})
}
export default new class Http {
get(url: string, params?: any): Promise {
return fetch(url, { method: 'get', params })
}
post(url: string, params?: any): Promise {
return fetch(url, { method: 'post', params })
}
put(url: string, body?: any): Promise {
return fetch(url, { method: 'put', body })
}
delete(url: string, body?: any): Promise {
return fetch(url, { method: 'delete', body })
}
}
6.12.2、baseUrl
// 参见本文6.13多环境开发
import { loadEnv } from 'vite'
runtimeConfig: { // 运行时常量
public: { // 客户端-服务的都能访问
baseUrl: loadEnv(process.argv[process.argv.length-1], './env').VITE_SERVER_NAME
}
},
6.12.3、utils/api.ts
import Http from '@/utils/request'
export const config1 = (params: any) => {
return Http.get('/m-staff-center/api/v1/pageList', params)
}
export const getVideoList = (params: any) => {
return Http.post('/m-staff-center/api/v1/getName', params)
}
6.12.4、使用
config1('').then((res: any) => {
console.log('27', res)
}).catch((err: any)=>{
console.log('29', err)
})
getVideoList('').then((res: any) => {
console.log('51', res)
}).catch((err: any)=>{
console.log('54', err)
})
经测试,成功。
6.13、多环境开发
生产使用的项目通常会有dev、test、uat、pre、prd等环境,我们需要配置多种开发环境满足企业级开发要求。
6.13.1、根目录创建env目录,创建环境变量文件
文件命名规则 .env.[环境变量名,如dev]
.env.dev文件,其他文件同理
# 请求接口地址
VITE_REQUEST_BASE_URL = '/m-staff-center/api/v1'
VITE_SERVER_NAME = 'https://md.abc.com.cn/'
# VITE开头的变量才会被暴露出去
6.13.2、package.json
"scripts": {
"build": "nuxt build",
"dev": "nuxt dev --mode dev",
"test": "nuxt dev --mode test",
"uat": "nuxt dev --mode uat",
"pre": "nuxt dev --mode pre",
"prd": "nuxt dev --mode prd",
"generate": "nuxt generate",
"preview": "nuxt preview",
"postinstall": "nuxt prepare"
},
6.13.3、nuxt.config.ts
import { loadEnv } from 'vite'
console.log('基础服务路径', loadEnv(process.argv[process.argv.length-1], './env').VITE_SERVER_NAME)
多环境配置成功,环境变量可以用于本地代理使用,如本地代理使用环境域名,等。
6.14、服务器部署
build:混合渲染模式,node启动项目(或者使用pm2),nginx做代理转发。
node
node ./.output/server/index.mjs
pm2
pm2 start ecosystem.config.js
// 使用pm2,根目录创建ecosystem.config.js
module.exports = {
apps: [
{
name: 'NuxtAppName',
exec_mode: 'cluster',
instances: 'max',
script: './.output/server/index.mjs',
}
]
}
未测试。
// nginx配置
{
listen 80;
server_name www.abc.com; // 域名
location / {
proxy_pass http://127.0.0.1:3000; // 转发到当前服务器3000端口
}
}
已测试,成功。
generate:预渲染模式,生成静态资源,nginx直接启服务。
已测试,成功。
6.15、其他内容
待补充
七、过程记录
7.1、init项目不成功
解1:墙内的同学可能创建不成功,这里推荐一个链接:https://github.com/nuxt/starter
解2:开始使用科学上网的方法也没有下载成功,后来使用了付费科学上网的方法下载成功。下载成功后如图。
7.2、useHead接收参数如下:
useHead(meta: Computable): void
interface MetaObject extends Record {
charset?: string
viewport?: string
meta?: Array>
link?: Array>
style?: Array>
script?: Array>
noscript?: Array>
titleTemplate?: string | ((title: string) => string)
title?: string
bodyAttrs?: Record
htmlAttrs?: Record
}
charset: 指定 HTML 的字元编码,预设为 utf-8。
viewport: 设定网页的可见区域,预设为 width=device-width, initial-scale=1。
meta: 接受一个阵列,阵列中的每个元素,都將会建立一个 标记,元素中物件的属性将对应至的属性。
link: 接受一个阵列,阵列中的每个元素,都将会建立一个 标记,元素中物件的属性将对应至的属性。
style: 接受一个阵列,阵列中的每個元素,都将会建立一个