创建VueCLI工程

2026年9月20日星期日·3507 字·18 分钟·
-浏览量
前端开发VueCSSJavaScriptVue
AI 摘要- DeepSeek

下载并安装Node.js,下载完成后,打开新的CMD/终端窗口,输入以下命令

创建VueCLI工程 - 封面图

创建Vue CLI工程#

步骤1:下载并安装Node.js

下载并安装Node.js,下载完成后,打开新的CMD/终端窗口,输入以下命令:

plaintext
npm -v

执行后,会提示版本号,则表示安装成功。

步骤2:配置npm源

在CMD/终端窗口中输入:

plaintext
npm config set registry https://registry.npm.taobao.org

执行后,不会有反馈。

以上命令用于配置npm源,则后续的下载软件都将从所配置的源服务器下载。

步骤3:安装vue/cli

在CMD/终端窗口中输入:

plaintext
npm install -g @vue/cli

执行后,会自动下载一些软件,在CMD/终端窗口中也会有许多信息,只要没有出现Error级别的错误,均可无视。

到此为止的所有操作,在每台电脑上,都是一次性操作。

步骤4:创建工程

(以下示例将把项目创建在F:\Vue-Workspace,此盘和文件夹名均可自行指定)

打开电脑中的文件夹窗口,找到F盘,新建名为Vue-Workspace的文件夹,然后,在CMD/终端窗口中输入:

plaintext
f:

执行后,再输入:

plaintext
cd f:\Vue-Workspace

再执行后,命令提示符应该是F:\Vue-Workspace,此时,再创建Vue CLI项目,则项目会出现在此文件夹中。

在CMD/终端窗口中输入:

plaintext
vue create jsd2203-csmall-web-client

输入完成后,按1次回车(按下后会卡顿一会,请等待),在接下来的提示中,

plaintext
选择`Manually choose featuers`,
再选择`Babel`、`Router`、`Vuex`,
再选择Vue的版本为`2.x`,
出现`Y/n`的选项时,直接回车即可,
然后选择`In package.json`,
最后的`y/N`选择也直接回车即可。

接下来,会自动完成创建过程,出现 Successfully created project cgb2202-csmall-web-client.提示即表示成功。

启动Vue CLI工程#

在CMD/终端窗口中,首先,确保当前位置存在package.json文件,此文件是项目的根目录下的文件,所以,输入命令之前的提示符应该是:

plaintext
F:\Vue-Workspace\jsd2203-csmall-web-client>

在此提示符下,输入启动项目的命令:

plaintext
npm run serve

执行以上命令后,会自动编译并启动此工程,在启动过程中,将看到 Compiled successfully in 2155ms提示,则表示启动成功。

启动成功的提示中还包括http://localhost:8080这样的网址,通过此网址即可访问此工程的运行效果(不同网络配置的电脑,提示的网址可能数量不同)。

在浏览器中输入以上网址,即可访问。

停止已启动的项目#

在CMD/终端窗口中,按下Ctrl + C即可停止已启动的项目。

(按下Ctrl + C时即已停止,所以,在弹出的提示中,无论选择Y或N都是等效的)

idea中terminal使用npm报不是内部或外部命令,也不是可运行的程序 或批处理文件

进入File->|Settings -> Tools -> Terminal 将shell path替换成此处内容:

plaintext
C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe

image
image
image
image

关于Vue CLI工程结构#

  • [.idea]:是IntelliJ IDEA管理项目时自动生成的,可以无视
  • [node_modules]:是当前项目所需的依赖项,不应该自行维护,注意:通常此文件夹不会提交到git,在得到git上的项目后,如果没有此文件夹,需要先执行npm install命令才可以
  • [public]:是当前项目启动后的根路径,可存放各种资源,例如.css文件、.js文件、图片文件等,如果在此文件夹下粘贴1.jpg,则可以通过http://localhost:8080/1.jpg查看到此文件,并且,还可以按需自行创建文件夹,则路径上也应该有文件名称
    • favicon.ico:项目的图标文件,每个项目在(编译后的)根目录下有此文件时,会在浏览器中显示此图标
    • index.html:当前项目的页面,在Vue CLI工程,将有且仅有这1个HTML页面
  • [src]
    • [assets]:资源文件夹,用于存放静态资源,通常包括.css文件、.js文件、图片文件等,需要注意,此处的文件都应该是不随着程序运行过程变化而发生变化的文件,例如logo.png在此处是正确的,但是,用户的“头像”则不应该放在此处
    • [components]:用于存放视图组件,且这些视图组件通常是被其它视图组件调用的,是可能复用的组件,并且,在不同的调用中,传入的参数可能不同
    • [router]
      • index.js:路由配置文件,主要配置访问路径与视图组件的对应关系
    • [store]
      • index.js:存储共享的量的文件
    • [views]:用于存放视图组件
    • App.vue:是index.html默认加载的视图文件
    • main.js:是当前项目的主JS文件,通常用于管理一些配置,例如添加了某些依赖项(例如Element UI)后,可能需要在此处导入,才可以使得各.vue文件中可以使用这些依赖项
  • .gitignore:用于配置哪些文件和文件夹不会提交到git,如果此项目不需要提交到git,则不需要此文件
  • babel.config.js:是Babel的配置文件,通常不关心,也不要修改
  • jsconfig.js:是js一些通常配置的文件,通常不关心,也不要修改
  • LICENSE:许可协议文件,默认的项目中通常没有此文件,在git上公开的项目通常都包含此文件
  • package.json:主要配置当前项目的依赖项与项目的编译打包等配置,通常不建议手动修改
  • package-lock.json:是自动管理的配置文件,通常不建议手动修改
  • README.md:当前项目的说明文件,如果此项目已提交到git,通常会显示在git的此项目的主页,通常,应该在此文件中对当前项目进行必要描述,例如:如何配置此项目、如何启动此项目、相关的注意事项等
  • vue.config.js:是Vue配置的文件,通常不关心,也不要修改

关于.vue文件

image
image
通常,.vue文件的源代码可以由3大部分组成:页面设计、样式、脚本,分别使用<template>、<style>、<script>节点。

关于<template>标签,其直接子标签必须有且仅有1个!

这3大部分并不全部都是必须的,例如某个.vue中没有<script>也是完全正常的!

在<template>的某个层级的子级,如果出现了<router-view />,表示此区域将由另一个视图文件来负责设计,至于是哪个视图, 取决于router/index.js中的路由配置。

关于路由的简单配置#

在router下的index.js文件是用于配置路由的,在此文件中有一个routes常量,其属性值是一个对象的数组,例如:

java
import HomeView from '../views/HomeView.vue'const routes = [ { path: '/', name: 'home', component: HomeView }, { path: '/about', name: 'about', component: () => import('../views/AboutView.vue') }]

数组元素中,通常具有3个属性:

  • path:路径,必须唯一
  • name:自定义名称,可以不必配置此属性
  • component:路径对应的视图组件(某个.vue文件加载得到的对象),有2种加载方式,第1种是在当前文件的起始位置(顶部)通过import语法静态导入(默认导入),第2种做法是在此component属性值位置使用箭头函数结合import函数进行导入,通常,在每个项目中,静态导入的视图组件应该只有1个

以上重点关注path和component的配置,当显示的视图组件中使用到了时,将根据当前访问的URL(浏览器中的路径)来决定显示哪个视图。

练习:做新的Other页面

  1. App.vue文件定义标签: Other

  2. router/index.js const routes = [ /…/ { path: ‘/other’, component: () => import(’../views/OtherView.vue’) } ]

  3. views文件夹中创建OtherView.vue

html
<template> <div> <h1>这是“其他”页面</h1> </div></template>

使用Element UI#

在CMD/终端窗口中,确保在当前项目的文件夹位置,执行安装Element Ui的命令:

npm i element-ui -S

安装完成后,还需要在main.js中添加配置:

java
import ElementUI from 'element-ui';import 'element-ui/lib/theme-chalk/index.css';Vue.use(ElementUI);

以上操作是每个项目中做1次的操作。

接下来,在当前项目的任何.vue文件中都可以直接使用Element UI进行设计。

使用Axios#

在CMD/终端窗口中,确保在当前项目的文件夹位置,执行安装axios的命令:

npm i axios -S 安装完成后,还需要在main.js中添加配置:

java
import axios from 'axios'Vue.prototype.axios = axios

以上操作是每个项目中做1次的操作。

接下来,在当前项目的任何.vue文件中都可以直接使用axios进行网络访问。

需要注意,目标服务器可能是禁止跨域访问的(错误提示中有CORS字样),在Spring Boot工程中,可以使得启动项目的类实现WebMvcConfigurer接口,并在此类中添加以下代码:

java
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOrigins("*") //.allowedOrigins("*")
.allowedMethods("*")
.allowedHeaders("*")
.allowCredentials(true)
.maxAge(3600);
}

使用Axios发请求的代码示例:

java
let url = 'http://localhost:8080/login';
console.log('url >>> ' + url);
let data = {'username': this.ruleForm.username,
'password': this.ruleForm.password
};
console.log('data >>> ');
console.log(data);
this.axios.post(url,data).then((response)=>{
console.log(response.data);
}).catch(function(error) {
console.log('响应结果为失败!');})

Vue CLI中的嵌套路由#

在开发实践中,一个项目中,可能部分页面完全没有共用的(需要复用的)部分,所以,在App.vue中,应该只有一个<router-view/>,没有其它标签,

仍有部分页面存在共用的部分,所以,在其它.vue文件中,也可能需要再次使用到<router-view />,其具体表现为在App.vue中只有<router-view/>,

则此处实现显示的就另外某个.vue,但是在这些.vue中会用到<router-view/>,即出现了“嵌套”。

操作步骤:

  1. 在App.vue中只保留一个<router-view />

  2. 在HomeView.vue中设计页面结构,且主体部分也是一个<router-view/>

  3. 新创建views/user/UserListView.vue和views/user/UserAddNewView.vue,在页面设计中,添加简单的文本表示页面是哪一个即可

  4. 在router/index.js中进行配置,例如:

    javascript
    const routes = [
    {
    // 因为被嵌套的<router-view>是在HomeView中的
    // 所以将在此处理配置嵌套路由
    // 使用children来配置子级路由,children子级的配置方式与routes子级的配置方式相同
    // 通常,应该配置redirect属性,表示重定向,因为一旦发现嵌套,原来的视图(例如HomeView)是不完整的,不应该允许直接访问
    // 以下配置重定向的效果:一旦访问 / 路径,就会自动跳转到 /user/list 路径
    path: '/',
    component: HomeView,
    redirect: '/user/list',
    children: [
    {
    path: '/user/list',
    component: () => import('../views/user/UserListView.vue')
    },
    {
    path: '/user/add-new',
    component: () => import('../views/user/UserAddNewView.vue')
    }
    ]
    }
    ]
    // 原有其它代码
  5. 最后,在访问时,使用例如http://localhost:8080/user/list类似的路径进行访问即可

在配置嵌套路由的路径时,推荐在父级路径上配置统一前缀,并在子级路径中使用相对路径进行配置,例如:

javascript
const routes = [
{
path: '/user', // 配置统一前缀
component: HomeView,
redirect: '/user/list',
children: [
{
path: 'list', // 不以 / 作为第1个字符,表示相对路径
component: () => import('../views/user/UserListView.vue')
},
{
path: 'add-new', // 不以 / 作为第1个字符,表示相对路径
component: () => import('../views/user/UserAddNewView.vue')
}
]
},
]

另外,还可以在<el-menu>上添加router,用于“启用菜单上的路由”,接下来,各菜单项的index属性值就可以配置为URL,在运行时,点击菜单项, 就可以跳转到对应的URL,例如:

vue
<!-- 以下新增了router属性 -->
<el-menu
router
default-active="/user/list"
class="el-menu-vertical-demo">
<el-submenu index="1">
<template slot="title">
<i class="el-icon-user-solid"></i>
<span>用户管理</span>
</template>
<!-- 以下菜单项的index值为对应的URL -->
<el-menu-item index="/user/list">
<i class="el-icon-location"></i>
<span>用户列表</span>
</el-menu-item>
<!-- 以下菜单项的index值为对应的URL -->
<el-menu-item index="/user/add-new">
<i class="el-icon-location"></i>
<span>添加用户</span>
</el-menu-item>
</el-submenu>
</el-menu>

Vue CLI的路由守卫#

路由守卫是一种类似Java Web中的“过滤器”的组件,它可以运行在每次发生路由跳转之前、之后, 主要用于解决一些“不管是哪个页面发生跳转都需要执行的任务”类似的问题。

例如,可以使用路由守卫来实现“每个页面都显示不同的标题栏文字”的效果。

因为Vue脚手架项目是单页面的,实质的HTML只有1个,则标题栏也只有固定的那一个,要实现“每个页面都显示不同的标题栏文字”, 只能“每次发生路由跳转时都重新设置标题栏文字”,并且,这个设置操作发生在跳转之前是相对更合理的。

可以在路由配置中,为每个路由配置添加meta,这是路由配置中,用于封装自定义信息的,然后,在其中定义title属性,用于配置标题栏文字,例如:

javascript
const routes = [
{
path: '/user',
component: HomeView,
redirect: '/user/list',
children: [
{
path: 'list',
component: () => import('../views/user/UserListView.vue'),
meta: { // 新增代码
title: '酷鲨商城运营管理平台 -- 用户列表'
}
},
{
path: 'add-new',
component: () => import('../views/user/UserAddNewView.vue'),
meta: { // 新增代码
title: '酷鲨商城运营管理平台 -- 添加用户'
}
}
]
}
]

然后,在路由配置文件中添加:

javascript
router.beforeEach((to, from, next) => {
if (to.meta.title) {
document.title = to.meta.title;
}
next();
})

注意:必须调用next(),否则,跳转过程就此结束,不会继续向后运行,页面也不会显示了。

练习:添加类别的页面#

  1. 在views下创建category/CategoryAddNewView.vue文件
  2. 在router/index.js中,在HomeView的children下配置此视图的路由,路径为/admin/category/add-new
  3. 测试:启动前端项目,在浏览器中通过/admin/category/add-new可以访问此视图
  4. 在HomeView的菜单中,添加对应的菜单项
  5. 测试:通过菜单可以访问此视图
  6. 将BrandAddNewView中的代码复制到CategoryAddNewView中,并将文字进行简单的修改,例如“品牌”改为“类别”
  7. 根据设计文档,调整CategoryAddNewView中的控件,其中,“上级类别”、“类别图标”暂时使用文本框输入数据来提供临时的使用
  8. 在CategoryAddNewView的JS代码部分,调整发请求、拿响应相关的代码,例如需要修改请求的URL
创建VueCLI工程
https://blog.fileoz.com/posts/vue-cli-project-setup/
作者
MIAOWU
发布于
2026-09-20
许可协议
CC BY-NC-SA 4.0

评论区

动作模组
等待模型加载…
看板娘
公告
公告大版本更新

一口气全面统一博客样式,移除部分冗余导航页面,更专注内容展示。

公告稳定性修复一批

统一Swup生命周期(BUG更少了、牺牲了首屏部分性能)、升级astro 7(构建速度翻倍)、文章封面图片加载(更流畅)、更换音乐播放器 API(更稳定)等多个问题,站点更稳了。

公告互换友链

欢迎各位大佬互换友链,要求内容原创、稳定更新。申请前请先看友链页的说明,期待和你交换链接。

查看详情
公告关于我的介绍

欢迎来到我的博客,我是深耕java、python和agent技术开发。热爱技术、持续学习,欢迎同好交流探讨。

查看详情
音乐
封面

音乐

暂未播放

0:00
0:00
暂无歌词

日历

正在加载日历...

--

    最近节日

    正在加载日历...
    ----

    最近生日/纪念日

    正在加载日历...
    ----
    距月底--
    距年底--

    隐私政策

    更新日期: 2026 年 7 月 15 日
    生效日期: 2026 年 7 月 15 日

    适用范围#

    本政策适用于 MiaoWu 的博客(以下简称“本站”)。本站是个人博客,用于发布和分享内容;不提供账户注册、支付、定位或广告投放服务。访问本站、发表文章评论或在留言板留言前,请阅读本政策。

    信息收集与使用#

    本站只在提供内容、评论和留言功能,以及维护站点安全所需的范围内处理信息。

    • 访问与统计信息:访问页面时,统计服务可能处理访问时间、页面地址、来源页、浏览器和设备相关信息,用于了解内容访问情况、排查故障和改进站点。
    • 评论信息:使用文章评论功能时,Waline 可能处理您主动提交的昵称、邮箱、站点链接和评论内容;还可能处理 IP 地址等必要信息,用于防止垃圾评论、滥用和维护服务安全。评论内容、昵称和站点链接(如填写)可能公开展示在文章下方;邮箱不会公开展示。
    • 留言信息:留言板使用 Waline /guestbook/ 频道。Waline 可能处理您主动提交的昵称、可选邮箱、站点链接、留言内容和图片,以及浏览器、操作系统、IP 地址等必要的反滥用信息。默认情况下,留言图片以内嵌数据随留言提交;如站点维护者配置了远程图片上传接口,图片会先发送至该接口并在留言中保存返回的图片地址。留言内容、昵称、图片和站点链接(如填写)可能公开展示;邮箱和 IP 地址不会在留言板公开展示。

    请不要在评论或留言中提交身份证件、银行卡、住址、密码或其他不必要的敏感个人信息。

    第三方服务#

    为实现本站功能,以下第三方会在各自服务范围内处理相关数据:

    • Umami:用于匿名化的网站访问统计和出站链接点击统计,帮助我了解本站的使用情况。
    • Waline:用于文章评论、留言板及访问量统计。服务会按照其自身规则处理您在评论或留言时提交的信息及必要的反滥用信息。
    • Cloudflare:可为本站提供静态资源分发和域名基础设施。
    • unpkg:用于加载 Waline 的前端脚本、样式和表情资源;请求这些资源时,您的浏览器会与该服务建立连接。

    第三方服务可能有独立的隐私政策和数据保存规则。请在使用相关功能前查阅其规则;本站无法控制其独立的数据处理活动。

    本站主要使用浏览器本地存储(Local Storage 或 Session Storage)保存使用偏好,例如主题颜色、明暗模式、文章列表视图和音乐播放设置。留言板会在本地保存匿名资料、未发送草稿和登录状态,以便恢复输入与会话;管理员登录状态仅保存在当前会话。

    本站不主动设置用于广告定向的第一方 Cookie。评论、统计或资源服务可能按照其自身规则使用 Cookie 或类似技术。您可以通过浏览器设置查看、删除或限制 Cookie 和本地存储;清除后,部分偏好或互动状态可能会恢复为默认值,评论功能也可能受到影响。

    信息公开、保存与安全#

    评论和留言属于公开互动内容,提交后可能被搜索引擎收录、被他人引用或在缓存中短暂保留。请谨慎决定发布内容。除非您提出删除请求、内容违反规则或法律法规另有要求,公开内容会持续保留以维持讨论上下文。

    本站会采取合理措施保护数据安全,包括使用 HTTPS、输入校验、内容转义和访问频率限制。但互联网传输和第三方服务均无法保证绝对安全,请理解并自行承担公开发布信息的相应风险。

    你的权利#

    你可以通过 996491835@qq.com 联系我,申请查询、更正或删除由本站直接保存的评论、留言或相关公开内容。为保护他人权益,请在请求中提供足以定位内容的信息,并说明你与该内容的关系;必要时可能需要进行合理核验。

    对于由 Waline、Umami、Cloudflare 或 unpkg 独立处理的数据,你也可以直接向对应服务提供方行使相关权利。删除公开评论或留言后,第三方缓存、搜索引擎索引或他人转载的副本可能无法立即同步删除。

    未成年人条款#

    未满 14 周岁的未成年人应在监护人同意和指导下使用本站的评论、留言等互动功能。监护人如发现未成年人未经同意提交了个人信息,可通过上述联系方式与我联系,我会在合理范围内协助处理。

    政策更新与联系#

    我可能因本站功能或适用规则变化更新本政策,更新后的版本将在本站公布并标明日期。继续使用相关功能即表示你已阅读并理解更新后的政策。

    如对本政策或数据处理有疑问,请联系 996491835@qq.com。

    用户协议

    更新日期: 2026 年 5 月 19 日
    生效日期: 2026 年 5 月 19 日

    适用范围#

    本协议适用于你访问 MiaoWu 的博客,以及使用文章评论、留言板等互动功能的行为。继续浏览本站或提交评论、留言,即表示你已阅读、理解并同意遵守本协议及本站的隐私政策。

    评论及留言规则#

    请在交流中保持友善、理性和尊重。你不得利用本站发布、传播或实施以下行为:

    • 发布任何违反中华人民共和国法律法规的内容。
    • 发布任何侵犯他人合法权益的内容,包括但不限于隐私、名誉、肖像、著作权、商标权和其他知识产权。
    • 恶意攻击、辱骂、骚扰、威胁、歧视其他用户或任何第三方。
    • 发布垃圾广告、恶意推广、刷屏、灌水,或与讨论主题明显无关的重复内容。
    • 利用本站进行网络诈骗、钓鱼、传播恶意软件,或发布可能危害网络和信息安全的内容。
    • 绕越或试图绕越本站的审核、限流、封禁等管理措施。
    • 冒充他人、伪造身份,或收集、公开他人的个人信息。

    内容与访问管理#

    你应对自己发布的评论和留言负责,并保证拥有发布该等内容所需的合法权利。论坛管理员有权在不另行通知的情况下删除违规内容、限制或封禁违规账号,或限制其继续使用本站互动功能。

    如发现涉嫌违法犯罪、严重侵权或危及本站安全的内容,本站可保留相关记录,并在法律法规要求或必要时向有关部门提供协助。对管理措施有疑问时,可通过文末联系方式说明情况;本站会结合实际情况处理,但不承诺恢复已删除内容或访问权限。

    知识产权与内容授权#

    本站原创文章、页面设计和其他受保护内容的权利归作者或权利人所有。未经授权,请勿复制、转载、镜像或用于商业用途;法律法规允许的合理使用除外。

    你发布评论或留言时,授予本站为展示、存储、备份、审核、删除和维护互动功能所必需的非独占、免费的使用许可。该许可不改变你对原创内容依法享有的权利。

    免责声明#

    本站内容仅用于个人记录、学习交流和一般信息参考,不构成任何专业意见、承诺或担保。你应结合自身情况独立判断,并对据此采取的行动负责。

    评论、留言和外部链接中的内容由其发布者或运营者负责,不代表本站立场。本站会在合理范围内处理明显违规内容,但不保证所有内容均及时发现,也不对第三方网站的可用性、内容、安全性或隐私实践承担责任。

    因网络故障、不可抗力、第三方服务异常、维护升级或超出合理控制范围的原因导致本站暂时无法访问、内容延迟或数据丢失的,本站会尽力恢复,但不承担由此产生的间接损失。

    未成年人条款#

    未满 14 周岁的未成年人应在监护人同意和指导下使用评论、留言等互动功能。监护人应协助未成年人理解本协议,并对其使用行为进行必要的引导。

    其他条款#

    我可以根据本站功能、管理需要或法律法规变化更新本协议,更新后的版本将在本站公布并标明日期。继续使用本站即视为接受更新后的协议。

    本协议的订立、执行和解释适用中华人民共和国法律。因本协议或使用本站产生争议时,双方应先友好协商;协商不成的,依法向有管辖权的人民法院解决。

    如对本协议或内容管理有疑问,请联系 996491835@qq.com。

    复制成功,转载请标注本文地址