Next.js项目如何在next.config中合并withFonts等插件与i18n配置
问题根源定位
- 配置文件的核心错误:同一文件内两次执行
module.exports,后导出的i18n配置会完全覆盖前一个导出的插件配置,所有Sass、图片、字体相关的插件逻辑全部失效,两个配置完全没有合并到一起。 - 废弃依赖的兼容性问题:你使用的
@zeit/next-sass、@zeit/next-css均为Next.js 9时代的停止维护插件,Next.js 10+版本已经原生支持CSS、Sass、静态资源导入能力,这类旧插件和新版Next的i18n、路由系统存在天然的兼容冲突。 - 多语言逻辑的错误:
useRouter是React Hook,按照规则只能在React组件内部或自定义Hook顶层调用,你将其放在独立的普通函数sth中调用,违反Hook使用规则,无法正确获取路由里的locale值。- 判断语句
locale === 'en' || 'undefined'存在逻辑错误:字符串'undefined'是永远为真的真值,整个判断不管locale是什么值都会返回英文配置,切换语言永远不生效。
修复方案
1. 重写next.config配置,合并所有能力
首先卸载无意义的旧依赖:@zeit/next-sass、@zeit/next-css、next-compose-plugins、next-images、next-fonts,这些能力现在Next.js原生已经支持,不需要额外插件。
替换为如下配置(所有能力合并到同一个导出对象,避免覆盖问题):
const path = require("path"); /** @type {import('next').NextConfig} */ const nextConfig = { // i18n配置和webpack自定义配置写在同一个导出对象内 i18n: { locales: ['en', 'fr'], defaultLocale: 'en', }, // 保留你自定义的webpack规则和路径配置 webpack(config) { config.module.rules.push({ test: /\.(eot|ttf|woff|woff2)$/, use: { loader: "url-loader", }, }); config.resolve.modules.push(path.resolve("./")); return config; }, }; module.exports = nextConfig;
注意:next.config的修改必须重启开发服务才能生效,热更新不会加载新的配置。
2. 修复多语言取值逻辑
将原有的普通sth函数改写为符合Hook规则的自定义Hook,同时修正判断逻辑:
import { useRouter } from 'next/router'; import fr from '../locales/fr'; import en from '../locales/en'; // 改写为合法的自定义Hook,遵守Hook命名规范 function useTranslation() { const router = useRouter(); const { locale } = router; // 修正判断逻辑:法语加载法语文案,其他情况 fallback 到英文配置 const t = locale === 'fr' ? fr : en; return t; } export default function Index() { // 在组件顶层调用自定义Hook const t = useTranslation(); return ( <> <IndexNavbar fixed /> <section className="header relative pt-16 items-center flex h-screen max-h-860-px"> <div className="container mx-auto items-center flex flex-wrap"> <div className="w-full md:w-8/12 lg:w-6/12 xl:w-6/12 px-4"> <div className="pt-32 sm:pt-0"> <h2 className="font-semibold text-4xl text-gray-700"> {t.homeMainTitle} </h2> </div> </div> </div> </section> </> ); }
效果验证
- 重启开发服务后,访问默认路径
/,会自动加载英文文案,匹配defaultLocale设置。 - 访问
/fr路径,会自动切换加载法语文案,验证i18n和自定义webpack配置均生效。
内容的提问来源于stack exchange,提问作者azzmi
相关产品推荐
相关产品推荐

