定制软件Nuxt3项目搭建（Nuxt3+element-plus+scss详细步骤）

小聊： 定制软件本次记录一次使用Nuxt3定制软件搭建的过程，内容包含Nuxt3的安装，基于Vite脚手架（默认）构建的vue3项目，element-plus定制软件的安装配置（可选），scss的安装（可选），定制软件目录结构的创建和解释。定制软件项目搭建前，定制软件可以先了解一下 Nuxt3：

目录


1. Nuxt3的安装

前提，确保有Nuxt3定制软件的安装环境

Node.js（必要）Visual Studio Code（推荐）Volar（推荐）
  • 1
  • 2
  • 3

node.js 定制软件版本之间有差异，安装Nuxt3定制软件目前官方推荐 v14 和 v16，定制软件或更高的版本。


1.1. 安装新建 Nuxt3 项目

定制软件首先在你的Nuxt3定制软件工作空间下新建一个Nuxt3项目，定制软件打开项目空间文件夹，在项目空间文件夹路径输入 cmd 或 powershell + 回车，打开命令窗口


  • 安装方式

1）方式一：npx 安装

npx 是 npm5.2 之后发布的一个命令，可以代替 npm 命令安装依赖或包。

npx nuxi init nuxt-app   # nuxt-app 是项目名
  • 1

1）方式二：pnpm 安装

pnpm 是 Node.js 的替代包管理器。它是 npm 的直接替代品，但速度更快、效率更高。

pnpm dlx nuxi init nuxt-app   # nuxt-app 是项目名
  • 1

因为 pnpm 和 npm 不是同一个东西，需要另外安装。如果你没有，可以建议安装使用。直接使用 npx 或 npm 安装 pnpm，（也可以开启 node 的包管理器 Corepack 自动装配它。）

安装 pnpm

npm install -g pnpm或npx pnpm add -g pnpm
  • 1
  • 2
  • 3
  • 注意

命令中的 nuxt-app 就是项目包名，也就是说，你在安装nuxt3 的同时会生成一个项目包，项目可自定义，如果刚开始定义包名是这个，也可以把项目删了重新新建项目。

没错，它的安装便是新建一个 Nuxt3 项目，中间不需要你选任何工具的配置，它已经默认帮你打造了一套优质舒适的开发环境。工具选择详情可见官网：


1.2. Nuxt3的启动使用

本人项目启动使用 VS Code 演示。

进入项目目录

cd nuxt-app
  • 1

使用 code . VSCode 内置命令，用VScode打开该项目

code .
  • 1

示例：

说明：图中的 ERROR 不是安装失败，是警告提示：“ExperimentalWarning: Fetch API是一个实验性的特性。这个特性随时都可能改变”。Fetch API 是提供了一个获取资源的接口，本项目创建是通过它去请求的，算是实验性使用，和项目本身没多大关系，能正常下载来 Nuxt3 项目就行。

另外，如果删除了项目再创建同一个名字的项目失败的话，换一个项目名就好了。


1.3. Nuxt3 运行端口

Nuxt3 使用 npm run dev 运行端口，但首先，我们得先打开 Terminal 输入 npm install 下载依赖

npm install
  • 1

运行 cmd 命令启动服务

npm run dev
  • 1

或者使用图形化命令 npm scripts


访问：http://localhost:3000/

目前为止，我们就可以开始开发Nuxt3项目啦。


2. element-plus的安装配置

  • 安装命令
npm install element-plusnpm install @element-plus/icons-vue
  • 1
  • 2
  • 配置

因为 element-plus 属于第三方插件，需要在 plugins 目录配置

新建 plugins 目录， 在目录下新建 element-plus.client.ts 文件（注意：默认必须在 plugins 下新建配置文件，这是“约定”，详情见 ）

我这里使用命令创建，当然，手动在项目根目录下创建也好。（关于为什么要加 .client 感兴趣请看：《》）

mkdir pluginscd .\plugins\new-item element-plus.client.ts	// powershell命令创建文件（cmd命令不同：type nul> element-plus.client.ts）
  • 1
  • 2
  • 3

在 element-plus.client.ts 中配置全局

import * as ElementPlus from 'element-plus/dist/index.full'import zhCn from 'element-plus/es/locale/lang/zh-cn' export default defineNuxtPlugin((nuxtApp) => {  nuxtApp.vueApp.use(ElementPlus, {    locale: zhCn,  })})
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

在 nuxt.config.ts 中全局配置样式 css 的位置

export default defineNuxtConfig({  css:[      'element-plus/dist/index.css',  ]})
  • 1
  • 2
  • 3
  • 4
  • 5

2.1. 演示使用

打开 app.vue ，初始内容如下，<NuxtWelcome /> 是官方的欢迎页面

<template>  <div>    <NuxtWelcome />  </div></template>
  • 1
  • 2
  • 3
  • 4
  • 5

替换成使用 element-plus 的代码查看是否安装配置成功

<template>  <div>    <el-row class="mb-4">      <el-button>Default</el-button>      <el-button type="primary">Primary</el-button>      <el-button type="success">Success</el-button>      <el-button type="info">Info</el-button>      <el-button type="warning">Warning</el-button>      <el-button type="danger">Danger</el-button>    </el-row>    <br />    <el-row>      <el-button :icon="Search" circle />      <el-button type="primary" :icon="Edit" circle />      <el-button type="success" :icon="Check" circle />      <el-button type="info" :icon="Message" circle />      <el-button type="warning" :icon="Star" circle />      <el-button type="danger" :icon="Delete" circle />    </el-row>  </div></template><script lang="ts" setup>import {  Check,  Delete,  Edit,  Message,  Search,  Star,} from "@element-plus/icons-vue";</script><style>body {  background-color: #000000;}</style>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38

npm run dev 启动项目，访问 http://localhost:3000/


3. scss安装和全局变量配置

  • 安装
npm install sass --save-dev
  • 1

3.1. 使用

在 app.vue 中使用

<style lang="scss">$bgColor: pink;body {  background-color: $bgColor;}</style>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7

npm run dev 启动项目，访问 http://localhost:3000/


3.2. 外部导入使用

在根目录下两层新建文件夹 assets\styles，在 styles 下新建 default.scss

在 default.scss 中写

$bgColor: skyblue;
  • 1

在 app.vue 中使用

<style lang="scss">// $bgColor: pink;@import "~/assets/styles/default.scss";body {  background-color: $bgColor;}</style>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7


3.3. 全局配置使用

在 nuxt.config.ts 中配置

export default defineNuxtConfig({    css:[        'element-plus/dist/index.css',    ],    vite: {        css: {            preprocessorOptions: {                scss: {                    additionalData: '@use "@/assets/styles/default.scss" as *;'	// 注意文件路径要配成自己的                }            }        }    }})
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14

在 default.scss 中写

$bgColor: orange;
  • 1

在 app.vue 中使用

<style lang="scss">// $bgColor: pink;// @import "~/assets/styles/default.scss";body {  background-color: $bgColor;}</style>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7

至此，本项目使用基本演示结束。



4. 拓展：Corepack 自动装载 pnpm

从 node v16.13 开始，Node.js 发布了用于管理包的管理器 Corepack，它可以管理 pnpm，但因为 Corepack 这是一项实验性功能，没有默认开启，所以你需要通过运行以下命令来启用它，启用它之后，就会自动装载 pnpm 了。

corepack enable
  • 1

但是，它小有可能不是最新版本的 pnpm。要升级它，去 查看是否是最新版本，并使用下列命令检查并切换你想要的 pnpm 版本并运行。

corepack prepare pnpm@<version> --activate
  • 1

示例：

C:\Users\Admini>pnpm -v'pnpm' 不是内部或外部命令，也不是可运行的程序或批处理文件。C:\Users\Admini>corepack enableC:\Users\Admini>pnpm -v7.13.3C:\Users\Admini>corepack prepare pnpm@7.13.4 --activatePreparing pnpm@7.13.4 for immediate activation...C:\Users\Admini>pnpm -v7.13.4
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14


随笔

网站建设定制开发 软件系统开发定制 定制软件开发 软件开发定制 定制app开发 app开发定制 app开发定制公司 电商商城定制开发 定制小程序开发 定制开发小程序 客户管理系统开发定制 定制网站 定制开发 crm开发定制 开发公司 小程序开发定制 定制软件 收款定制开发 企业网站定制开发 定制化开发 android系统定制开发 定制小程序开发费用 定制设计 专注app软件定制开发 软件开发定制定制 知名网站建设定制 软件定制开发供应商 应用系统定制开发 软件系统定制开发 企业管理系统定制开发 系统定制开发