一.  初始化报错，报错如下：

Error: Failed to download template from registry: fetch failed

查了下，大致原因是下载被限制了。

网上解决方法是 ： 

hosts 文件中添加配置，我这边是不起效果的，没作用。

我的解决方法是：

git clone -b v3 https://github.com/nuxt/starter.git

直接拉取代码，但是个空壳，全部需要自己配置， 图如下：

后续会自己配置完全 

二.  安装 pinia 报错

Cannot start nuxt:  Cannot find module 'pinia/dist/pinia.mjs' 

找不到这个模块，目前也不知道是什么问题，跟着官网来下载依赖以及配置的：

解决办法如下：

npm install --save pinia @pinia/nuxt pinia-plugin-persist --legacy-peer-deps

执行这个命令就可以啦 

三.  用 useFetch 方法 post 请求 ，需要参数不拼接在 URL 上 就需要参数  body

四.  用 useHead() 方法配置SEO，值没有显示的问题

原来在 useHead() 方法中读取不需要 .value，跟模板中读取一样。

上图中的 1 和 2 是俩个方法，都可以设置当前页的 SEO。

五.  使用 ElementPlus 更换语言

1. 在  plugins 文件下创建  element-plus.client.ts ， 添加 .client 表示文件在客户端执行

import ElementPlus from 'element-plus'
import zhCn from 'element-plus/es/locale/lang/zh-cn'
export default defineNuxtPlugin(nuxtApp => {
  nuxtApp.vueApp.use(ElementPlus, {
    locale: zhCn,
  })
})

2. 在 nuxt.config.ts 里面配置，如下图：

六.  页面跳转执行 loading 动画，请求接口执行 loading 动画

1. 在 components 文件下 创建 Loading.vue 组件，代码如下：

2. 在 app.vue 使用 Loading 组件，并使用变量控制， 代码如下： 

3.  页面跳转执行 loading 动画

在 plugins 文件下 创建 loading.ts 代码如下：

export default defineNuxtPlugin((nuxtApp) => {
  const store = useNuxtStore();
  nuxtApp.hooks.hook('page:start', () => {
    store.$patch({
      loading: true,
    })
  });
  nuxtApp.hooks.hook('page:finish', () => {
    setTimeout(() => {
      store.$patch({
        loading: false,
      })
    }, 800);
  });
});

在 nuxt.config.ts  里面配置，代码如下：

用到全局变量放着 pinia 中， 如下图：

4. 请求接口执行 loading 动画

在 composables 文件夹下创建 common.ts ，此文件中的方法自动导入的， 直接导出就可以哪需要写哪， 代码如下：

export const nuxtLoading = (val: boolean) => {
  const store = useNuxtStore();
  if(val) {
    store.$patch({
      loading: val,
    })
  } else {
    setTimeout(() => {
      store.$patch({
        loading: val,
      })
    }, 500)
  }
};

页面请求接口代码如下： 

const reportList = (params: any) => {
  nuxtLoading(true); // 请求开启动画
  http.get('/index/list', params).then(res => {
    nuxtLoading(false); // 成功结束动画
  }).catch(() => {
    nuxtLoading(false); // 请求失败结束动画
  });
};

七.  useFetch 方法请求接口报错后会调用俩次

原因： Nuxt 3的SSR（服务器端渲染）特性和错误重试机制有关；

在Nuxt 3的SSR环境中，数据获取方法（如useFetch）会在服务器端执行一次，然后在客户端再次执行以同步状态。如果请求在服务器端失败，它可能在客户端再次尝试，这看起来像是请求被调用了两次。

解决方法：

让接口禁止在客户端再次执行

const { data, error } = await useFetch('/api/data', {
  // 仅在客户端执行请求
  server: false
});

八. 配置环境变量 env

1. 创建 env 文件，如下图：

VITE_PACK_ENV = dev
VITE_API_BASE = http://api.aaa.com
VITE_PUBLIC_API_BASE = http://api.admin.com

2. nuxt.config.ts 文件中的配置

 代码如下图：

import { loadEnv } from 'vite'
interface VITE_ENV_CONFIG {
  VITE_PACK_ENV: string,
  VITE_API_BASE: string,
  VITE_PUBLIC_API_BASE: string,
}
const envScript = (process.env as any).npm_lifecycle_script.split(' ');
const envName = envScript[envScript.length - 1]; // 通过启动命令区分环境
const envData = loadEnv(envName, 'env') as unknown as VITE_ENV_CONFIG;
console.log('当前环境：', envData)

 在  defineNuxtConfig 中 配置 runtimeConfig 属性：

  runtimeConfig: {
    // 只能在服务端拿到
    isServer: true,
    // 服务端 和 客户端 都能拿到
    public: {
      apiBase: envData.VITE_API_BASE,
      sourceIp2: envData.VITE_PUBLIC_API_BASE,
    },
  },

九. 执行打包命令后报错

Nuxt Build Error: Could not load F:/NUXT3.0--\u516C\u53F8/mmgcn.qyrdata.com/pages/index.vue?vue&type=style&index=0&scoped=963f1ac1&lang.less?inline&used: ENOENT: no such file or directory, open 'F:/NUXT3.0--\u516C\u53F8/mmgcn.qyrdata.com/pages/index.vue'

就是说找不到路径 pages/index.vue 

原因猜测可能有：

1. 文件确实不存在：首先，你需要确保 pages 目录下的 index.vue 文件确实存在。在你的 Nuxt.js 项目中，pages 目录是用来存放页面组件的，每个 .vue 文件都代表一个页面。

2.文件路径问题：另一个可能的原因是文件路径的问题。错误信息中显示的文件路径是 F:/NUXT3.0--\u516C\u53F8/mmgcn.qyrdata.com/pages/index.vue，它可能受到路径分隔符的影响。请确保文件路径的格式是正确的，例如在 Windows 上使用正斜杠 / 或者双反斜杠 \\。

3.环境变量问题：有时，构建过程中可能会受到环境变量的影响，导致文件路径解析错误。确保你的项目配置和环境变量设置正确。

最后发现都不是出现报错的问题所在，

根源尽然是最外层的文件名是中文，这是个非常低级的错误，羞愧。

改了再次打包就没有问题了。

结尾.  git地址

Nuxt3--npm: 版本Nuxt3.0.0, node -- v18.16.0

                             ————项目搭建完成了，已放个人的git上公开，需要的小伙伴可以拉取

                                                                                                                                        ——— 安夏