Frontend Academy · 课时

Nuxt 模块：图像、身份验证与国际化

安装并配置 @nuxt/image 以优化图像，使用 @nuxtjs/auth-next 实现身份验证，并使用 @nuxtjs/i18n 实现国际化。

Nuxt 模块：图像、身份验证与国际化 是 CoddyKit 上的免费 Frontend Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Frontend Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Frontend Academy 课程共包含 4 节课。

Nuxt 模块是什么

模块是 Nuxt 的官方扩展机制。模块会在 nuxt.config.ts 中安装，并接入构建、运行时和开发服务器。生态系统中的大多数功能都以模块形式提供。

安装模块

使用 npm install 安装模块，然后将其添加到 nuxt.config.ts 中的 modules。

// nuxt.config.ts
export default defineNuxtConfig({
  modules: [
    '@nuxt/image',
    '@sidebase/nuxt-auth',
    '@nuxtjs/i18n'
  ]
});

@nuxt/image

用经过优化的 <NuxtImg> 替代 <img>：自动转换格式（WebP/AVIF）、响应式 srcset、延迟加载和 CDN 集成。

<template>
  <NuxtImg
    src="/photos/sunset.jpg"
    alt="Sunset"
    width="800"
    height="600"
    format="webp"
    loading="lazy"
    sizes="sm:100vw md:50vw lg:800px"
  />
</template>

使用 NuxtPicture 实现艺术指导

<NuxtPicture> 会生成一个包含多个 <source> 标签的 <picture> 元素，用于艺术指导。

<NuxtPicture src="/hero.jpg" alt="" :imgAttrs="{ width: 1200, height: 600 }" />

图像提供商配置

配置 CDN 提供商（Cloudinary、imgix、Vercel 等），让所有图像都通过该提供商传输。

export default defineNuxtConfig({
  modules: ['@nuxt/image'],
  image: {
    provider: 'cloudinary',
    cloudinary: { baseURL: 'https://res.cloudinary.com/yourname/image/fetch/' }
  }
});

@sidebase/nuxt-auth（身份验证）

支持多个提供商的身份验证模块：兼容 NextAuth 的 OAuth、本地凭据和自定义流程。

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@sidebase/nuxt-auth'],
  auth: {
    baseURL: process.env.AUTH_ORIGIN,
    provider: { type: 'authjs' }
  }
});

在页面中使用身份验证

useAuth() 可组合函数提供会话、状态以及 signIn/signOut。

<script setup>
const { data: session, status, signIn, signOut } = useAuth();
</script>

<template>
  <button v-if="status === 'unauthenticated'" @click="signIn('github')">
    Sign in with GitHub
  </button>
  <div v-else>
    Welcome, {{ session.user.name }}
    <button @click="signOut">Sign out</button>
  </div>
</template>

使用中间件保护路由

在页面上使用身份验证中间件，要求用户完成身份验证。

<script setup>
definePageMeta({ middleware: 'auth' });
</script>

@nuxtjs/i18n（国际化）

官方 i18n 模块支持多种语言、带区域设置前缀的路由、延迟加载的翻译文件，以及对 SEO 友好的 hreflang。

export default defineNuxtConfig({
  modules: ['@nuxtjs/i18n'],
  i18n: {
    locales: [
      { code: 'en', file: 'en.json' },
      { code: 'tr', file: 'tr.json' }
    ],
    defaultLocale: 'en',
    lazy: true,
    langDir: 'locales/'
  }
});

在组件中进行翻译

在模板中使用 $t，或在 setup 中使用 useI18n。

<script setup>
const { t, locale } = useI18n();
</script>

<template>
  <h1>{{ $t('welcome') }}</h1>
  <p>{{ t('greeting', { name: 'Alice' }) }}</p>
  <button @click="locale = locale === 'en' ? 'tr' : 'en'">
    {{ $t('switch_lang') }}
  </button>
</template>

带区域设置前缀的路由

URL 会变为 /en/about、/tr/about。使用 localePath('/about') 生成带有正确前缀的链接。

<NuxtLink :to="localePath('/profile')">{{ $t('profile') }}</NuxtLink>

其他常用模块

@pinia/nuxt（状态管理）、@vueuse/nuxt（200 多个可组合函数）、@nuxtjs/tailwindcss（Tailwind 配置）、@nuxtjs/color-mode（深色模式）、@nuxt/content（基于文件的 CMS）。

编写自定义模块

对于内部单体仓库功能，请编写一个接入 Nuxt 生命周期的模块。模块功能强大：可以注册组件、运行时配置、服务器路由和构建步骤。

快速检查

哪个 Nuxt 3 模块可以通过自动生成 WebP/AVIF 和响应式 srcset 来提供经过优化的图像加载？

回顾：Nuxt 模块

模块可以扩展 Nuxt——通过 nuxt.config.ts 中的 modules 数组安装。@nuxt/image 用于优化图片（自动转换格式、srcset、延迟加载）。@sidebase/nuxt-auth（或 nuxt-auth）用于身份验证。@nuxtjs/i18n 用于翻译和带区域设置前缀的路由。此外还有：@pinia/nuxt、@vueuse/nuxt、@nuxtjs/tailwindcss、@nuxt/content。对于内部复用的功能，可以编写自定义模块。

常见问题解答

「Nuxt 模块：图像、身份验证与国际化」课时是免费的吗？

是的 — 「Nuxt 模块：图像、身份验证与国际化」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Frontend Academy 课程的其余内容，请升级到 CoddyKit PRO。 Frontend Academy 课程共包含 4 节课。

「Nuxt 模块：图像、身份验证与国际化」这节课中我会学到什么？

安装并配置 @nuxt/image 以优化图像，使用 @nuxtjs/auth-next 实现身份验证，并使用 @nuxtjs/i18n 实现国际化。你通过在浏览器中直接运行的动手代码来练习 Frontend Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Frontend Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Frontend Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「Nuxt 模块：图像、身份验证与国际化」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Frontend Academy 课中编写并运行代码吗？

能。每节 Frontend Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Frontend Academy