基于NPM通过Vue-CLI脚手架动手构建一个SPA项目

什么是脚手架?

可以快速生成新项目的目录模板(Node.js),将复杂的前端项目分成多个系统化的模块,便于管理和编辑,简化开发的软件。

什么是Vue-CLI?

是一个基于 Vue.js 进行快速开发的完整系统,一种交互式的项目脚手架,用于自动生成vue.js+webpack的项目模板(要使用此脚手架必须先准备vue,vue-cli,webpack,node等一些必要的环境)。

什么是webpack?

WebPack可以看做是模块打包机:它做的事情是,分析你的项目结构,找到JavaScript模块以及其它的一些浏览器不能直接运行的拓展语言(Scss,TypeScript等),并将其打包为合适的格式以供浏览器使用。

今的很多网页其实可以看做是功能丰富的应用,它们拥有着复杂的JavaScript代码和一大堆依赖包。为了简化开发的复杂度,社区涌现出了模块化的处理方案。

对于webpack看来一切都是模块,这就是它不可不说的优点,包括你的JavaScript代码,也包括CSS和fonts以及图片等等等,只有通过合适的loaders,它们都可以被当做模块被处理。

安装Vue-CLI

npm install -g vue-cli

安装成功后在全局配置(global)目录会出现以下文件:

  • vue
  • vue.cmd
  • vue-init
  • vue-init.cmd
  • vue-list
  • vue-list.cmd

构建项目

1.打开cmd窗口,cd到你自定义的项目目录下,然后执行:

vue init webpack spa1                                    //此命令用于创建SPA项目,他会在当前页面生成一个"spa1"的项目目录.

2.然后进入一问一答模式:

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!

3.启动项目,可以看到Vue-CLI的欢迎页

切换到项目所在目录 : cd spa1    
运行项目 : npm run dev

注意启动后的项目默认的调试地址是8080端口,而这端口很容易发生冲突(比如Tomcat的默认启动端口),可以通过以下方式更新。

config --> index.js //进入所在项目的此配置文件
dev: {
// Paths
assetsSubDirectory: 'static',
assetsPublicPath: '/',
proxyTable: {},
host: 'localhost', 
port: 8083, // 在这里修改端口号
autoOpenBrowser: false,
errorOverlay: true,
notifyOnErrors: true,
},

4.Vue项目结构说明

  •  build文件夹:这个文件夹主要是进行webpack(模块打包器,他可以递归的打包项目中的所有模块,最终生成几个打包后的文件)的一些配置
    •   webpack.base.conf.js webpack基础配置,开发环境,生产环境都依赖
    •   webpack.dev.conf.js webpack开发环境配置
    •   webpack.prod.conf.js webpack生产环境配置
    •   build.js 生产环境构建脚本
    •   vue-loader.conf.js 此文件是处理.vue文件的配置文件
  • config文件夹:
    •   dev.env.js 配置开发环境
    •   prod.env.js 配置生产环境
    •   index.js 这个文件进行配置代理服务器,例如:端口号的修改
  • node_modules文件夹 存放npm install时根据package.json配置生成的npm安装包的文件夹
  • src文件夹 源码目录(开发中用得最多的文件夹)
    •   assets 共用的样式、图片
    •   components 业务代码存放的地方,里面分成一个个组件存放,一个页面是一个组件,一个页面里面还会包着很多组件
    •   router 设置路由
    •   App.vue vue文件入口界面
    •   main.js 对应App.vue创建vue实例,也是入口文件,对应webpack.base.config.js里的入口配置
  • static文件夹 存放的文件不会经过webpack处理,可以直接引用,例如swf文件如果要引用可以在webpack配置,对swf后缀名的文件处理的loader,也可以直接将swf文件放在这个文件夹引用
  • package.json 这个文件有两部分是有用的:scripts 里面设置命令以及在dependencies和devDependencies中,分别对应全局下载和局部下载的依赖包

package.json详解

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

  "name": "spa_01",//项目名称
  "version": "1.0.0",//版本号
  "description": "A Vue.js project",//项目描述
  "author": "star",//作者
  "private": true,//是否私有,false将作为公共项目保存到npm上。
  "scripts": {
    "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",//webpack的启动指令,包含了项目的启动配置
    "start": "npm run dev",//启动命令
    "build": "node build/build.js"//运行时启动编译,(热加载)
  "dependencies": {//生产和开发过程中都需要的包
    "element-ui": "^2.13.2",//饿了吗推出的基于Vue.js的样式框架
    "vue": "^2.5.2",//Vue核心js文件
    "vue-router": "^3.0.1"//Vue的路由器文件
"devDependencies": //只在开发过程中所依赖的包,生产环境下不会打包这里的内容
      //version,必须匹配某个版本,如:1.1.2,表示必须依赖1.1.2版
      //>version,必须大于某个版本,如:>1.1.2,表示必须大于1.1.2版
      //~version,大概匹配某个版本,~1.1.2,表示>=1.1.2 <1.2.0
      //^version,兼容某个版本,如:^1.1.2 ,表示>=1.1.2 <2.0.0
  "engines": {//指定包的运行环境NodeJS
    "node": ">= 6.0.0",//至少6版本以上
    "npm": ">= 3.0.0"
  }
  "browserslist": [//根据提供的目标浏览器的环境来,智能添加css前缀,js的polyfill垫片,来兼容旧版本浏览器
    //last 2 versions:CanIUse.com追踪的IE最新版本为11,向后兼容两个版本即为10、11
    "> 1%",
    "last 2 versions",
    "not ie <= 8"
  ]

什么是*.vue文件?

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

posted @ 2020-09-19 19:24  _未来可期  阅读(201)  评论(0编辑  收藏  举报