使用vue-cli来搭建vue项目

关注

原创最新推荐文章于 2026-06-15 11:05:44 发布 288 阅读 AI 写同款· GEO 优化 ›

Vue-cli搭建项目 Vue-cli是Vue.js官方提供的脚手架工具，用于快速生成Vue项目模板，简化开发流程。使用Vue-cli前需安装Node.js和npm，Node.js是JavaScript的运行环境，而npm是Node.js的包管理工具。通过Vue-cli创建项目后，项目结构包括node_modules、public、src等目录，其中src目录包含应用的主要代码。在项目中，可以通过配置vue-router来管理路由，实现单页应用中的组件切换。创建并配置好项目后，通过npm run serve命令启动项目，检查是否搭阅读详情

使用vue-cli来搭建vue项目

介绍vue-cli
安装vue-cli和webpack
- 测试安装是否成功
使用脚手架vue-cli(2.X版)来构建项目
package.json详解
npm install/npm install xxx -S/npm install xxx -D/npm install xxx -g的区别
vue项目结构说明
在spa项目里使用路由
路由嵌套

介绍vue-cli

vue-cli是vue.js的脚手架，用于自动生成vue.js+webpack的项目模板，创建命令如下：

vue init webpack xxx

    注1：xxx 为自己创建项目的名称
    注2：必须先安装vue,vue-cli，webpack，node等一些必要的环境

安装vue-cli和webpack

命令如下：
npm install -g vue-cli
npm install -g webpack

在这里插入图片描述
安装成功后
node_global文件下会有以下文件：
vue
vue.cmd
vue-init
vue-init.cmd
vue-list
vue-list.cmd

测试安装是否成功

安装完成之后打开命令窗口并输入 vue -V（注意这里是大写的“V”），如果出现相应的版本号，则说明安装成功。
在这里插入图片描述

使用脚手架vue-cli(2.X版)来构建项目

1 ,使用脚手架创建项目骨架(此步骤可理解成使用eclipse创建一个maven的web项目)
1-1,cmd 打开命令窗口
1-2,cd 进入你指定的工作目录（我的为D:\myVue）
1-3,vue init webpack spa1
此命令用于创建SPA项目，它会在当前目录生成一个以“spa1”命名的文件夹

解决编码问题：
cmd命令行窗口显示中文乱码，多是因为cmd命令行窗口字符编码不匹配导致
修改cmd窗口字符编码为UTF-8，命令行中执行：chcp 65001
切换回中文：chcp 936
这两条命令只在当前窗口生效，重启后恢复之前的编码。

“一问一答”模式
1.Project name：项目名，默认是输入时的那个名称spa1，直接回车
2.Project description：项目描述，直接回车
3.Author：作者，随便填或直接回车
4.Vue build：选择题，一般选第一个
4.1Runtime + Compiler: recommended for most users//运行加编译，官方推荐，就选它了
4.2Runtime-only: about 6KB lighter min+gzip, but templates (or any Vue-specific HTML) are ONLY allowed in .vue files
- render functions are required elsewhere//仅运行时，已经有推荐了就选择第一个了
5.Install vue-router：是否需要vue-router，Y选择使用，这样生成好的项目就会有相关的路由配置文件
6.Use ESLint to lint your code：是否用ESLint来限制你的代码错误和风格。N 新手就不用了，但实际项目中一般都会使用，这样多人开发也能达到一致的语法
7.Set up unit tests：是否安装单元测试 N
8.Setup e2e tests with Nightwatch?：是否安装e2e测试 N
9.Should we run npm install for you after the project has been created? (recommended) (Use arrow keys)
Yes, use NPM
Yes, use Yarn
No, I will handle that myself //选择题：选第一项“Yes, use NPM”是否使用npm install安装依赖
全部选择好回车就进行了生成项目，出现如下内容表示项目创建完成
# Project initialization finished!
# ========================
实在不会选，就回车选择“默认”或是选择“N”不安装

在这里插入图片描述

2，运行完上面的命令后，我们需要将当前路径改变到SPA这个文件夹内，然后安装需要的模块（此步骤可理解成maven的web项目创建成功后，修改pom文件添加依赖）

  cd spa1               #改变路径到spa1文件夹下
  npm install          #安装所有项目需要的npm模块

3，启动并访问项目（此步骤可理解成启动tomcat，并通过浏览器访问项目）

cd spa1 
npm run dev


注1：项目启动成功后，打开浏览器输入“http://localhost:8080”即可
注2：vue-cli构建的项目，在控制台npm run dev启动后，默认的调试地址是8080端口的但是大部分时候，
        我们都要并行几个项目开发，很有可能已经占用了8080端口，所以就涉及到如何去更改调试地址的端口号了
        config --> index.js  
        dev: {
          // Paths
          assetsSubDirectory: 'static',
          assetsPublicPath: '/',
          proxyTable: {},
          host: 'localhost', 
          port: 8083,       // 在这里修改端口号
          autoOpenBrowser: false,
          errorOverlay: true,
          notifyOnErrors: true,
        },

在这里插入图片描述

4，停止项目添加element-ui模块
cd spa1
npm install element-ui -S #-S就是-save的缩写

使用vue+elementUI创建SPA项目，一般情况下其项目结构组成如下：
Vue + ESLint + webpack + elementUI + ES6
Vue: 主要框架
ESLint: 帮助我们检查Javascript编程时的语法错误，这样在一个项目中多人开发，能达到一致的语法
Webpack: 设置代理、插件和loader处理各种文件和相关功能、打包等功能。整个项目中核心配置
elementUI: 是基于vue的一套样式框架，里面有很多封装好的组件样式
ES6: 全称ECMAScript6.0，是JavaScript的下一个版本标准，2015.06发版

package.json详解

每个项目的根目录下面，一般都有一个package.json文件，定义了这个项目所需要的各种模块，
以及项目的配置信息（比如名称、版本、许可证等元数据）。npm install命令根据这个配置文件，
自动下载所需的模块，也就是配置项目所需的运行和开发环境

npm install/npm install xxx -S/npm install xxx -D/npm install xxx -g的区别

1 ，npm install
下载“package.json”中dependencies和devdependencies中配置的所有依赖模块，并保存到项目的node_modules目录

  注1：在git clone项目的时候，项目文件中并没有node_modules文件夹，为什么呢？

2 ，npm install xxx -g
全局安装，下载依赖模块，并保存到%node_home%\node_global\node_modules目录下

3 ，npm install xxx -S
写入到package.json的dependencies对象，并保存到项目的node_modules目录

4 ， npm install xxx -D
写入到package.json的devDependencies对象，并保存到项目的node_modules目录

在git clone项目的时候，项目文件中并没有node_modules文件夹，为什么呢？
我们知道这个文件中(project_home\node_modules)保存的是我们项目开发中所使用的依赖模块。这个文件夹可能有几百兆大小，
如果放到github上，其它人clone的时候会非常慢，这个时候就想到用一个package.json依赖配置文件解决这个问题。
这样每个人下载这个项目的时候，只需要进入该项目目录直接npm install npm就会到里面去找需要的函数库，也就是依赖。

缩写命令的全称，注意大小写、-S,-D都是大写
       i/install
       -S/--save
       -D/--save-dev 
       -g/--global

package.json文件里面的devDependencies和dependencies对象有什么区别呢？
       devDependencies里面的插件只用于开发环境，不用于生产环境，而dependencies是需要发布到生产环境的。
       例如：gulp ，babel，webpack一般都是辅助工具，应该使用--save-dev安装到开发环境
       例如：vue ,react，应该使用--save 安装到生产环境

vue项目结构说明

1， build文件夹
这个文件夹主要是进行webpack的一些配置
1-1，webpack.base.conf.js
webpack基础配置,开发环境,生产环境都依赖
1-2， webpack.dev.conf.js
webpack开发环境配置
1-3，webpack.prod.conf.js
webpack生产环境配置
1-4， build.js
生产环境构建脚本
1-5， vue-loader.conf.js
此文件是处理.vue文件的配置文件

2， config文件夹
2-1， dev.env.js
配置开发环境
2-2， prod.env.js
配置生产环境
2-3，index.js
这个文件进行配置代理服务器，例如：端口号的修改

3， node_modules文件夹
存放npm install时根据package.json配置生成的npm安装包的文件夹

4， src文件夹
源码目录(开发中用得最多的文件夹)
4-1， assets
共用的样式、图片
4-2， components
业务代码存放的地方，里面分成一个个组件存放，一个页面是一个组件，一个页面里面还会包着很多组件
4-3， router
设置路由
4-3-1， App.vue
vue文件入口界面
4-3-2，main.js
对应App.vue创建vue实例，也是入口文件，对应webpack.base.config.js里的入口配置

5， static文件夹
存放的文件不会经过webpack处理，可以直接引用，例如swf文件如果要引用可以在webpack配置对swf后缀名的文件处理的loader，也可以直接将swf文件放在这个文件夹引用

5-1， package.json
这个文件有两部分是有用的：scripts 里面设置命令以及在dependencies和devDependencies中，分别对应全局下载和局部下载的依赖包

 *.vue 文件：
 *.vue 文件，是一个自定义的文件类型，用类似HTML的语法描述一个Vue组件。
   每个.vue文件包含三种类型的顶级语言块 <template>, <script> 和 <style>。
   这三个部分分别代表了 html,js,css。


   注1：不能直接把html代码包裹在<template></template>中，而是必须在里面方置一个html标签来包裹所有的代码。 
        一般情况是使用<div></div>标签包含其它的代码(保证只有一个根元素)
         <template>
           <div>...</div>
         </template>
   注2：js代码写在<script>标签中，并通过export导出
        <script>
          export default {
             name: 'App'
          }
        </script> 
   注3：样式与以前的写法一样

在spa项目里使用路由

1、将原有的路由设置取消
APP.vue的logo注释掉
2、自定义一个Home.vue文件

<template>
	<div>
		首页内容
	</div>
</template>

<script>
	export default {
		data() {
			return {
				
			};
		}
	}
</script>

<style>

</style>

3、修改src/router/index.js路由配置

import Vue from 'vue'
import Router from 'vue-router'
import HelloWorld from '@/components/HelloWorld'
import Home from '@/components/Home'
Vue.use(Router)

export default new Router({
  routes: [
    {
      path: '/',
      name: 'Home',
      component: Home
    }
  ]
})

路由嵌套

已经有了一个Home.vue组件
我再创建一个用户组件

<template>
	<div>
		<router-link to="/User/Info">用户详情</router-link>
		<router-link to="/User/Pwd">密码修改</router-link>
    <router-view/>
	</div>
</template>

<script>
	export default {
		data() {
			return {
				
			};
		}
	}
</script>

<style>

</style>

创建用户组件下的两个子组件，Info.vue和Pwd.vue
Info.vue:

<template>
	<div>
		用户详情页面
	</div>
</template>

<script>
	export default {
		data() {
			return {
				
			};
		}
	}
</script>

<style>

</style>

Pwd.vue:

<template>
	<div>
		密码修改页面
	</div>
</template>

<script>
	export default {
		data() {
			return {
				
			};
		}
	}
</script>

<style>

</style>

router下的index.js的配置

import Vue from 'vue'
import Router from 'vue-router'
import HelloWorld from '@/components/HelloWorld'
import Home from '@/components/Home'
import User from '@/components/User'
import Info from '@/components/Info'
import Pwd from '@/components/Pwd'
Vue.use(Router)

export default new Router({
  routes: [
    {
      path: '/',
      name: 'Home',
      component: Home
    },
		{
			path: '/Home',
			name: 'Home',
			component: Home
		},
		{
			path: '/User',
			name: 'User',
			component: User,
			children:[
				{
					path: '/User/Info',
					name: 'Info',
					component: Info
				},
				{
					path: '/User/Pwd',
					name: 'Pwd',
					component: Pwd
				}
			]
		}
		
  ]
})

测试结果：
在这里插入图片描述
一个简单的嵌套路由就完成了！