美文网首页
vue-cli 2搭建前端项目

vue-cli 2搭建前端项目

作者: Innocencellh | 来源:发表于2019-07-16 10:07 被阅读0次

    目前主流的前端开发框架有React、Angular和Vue。随着webpack等工具的兴起,前端项目的构建和打包开始工程化,但是针对不同的前端框架以及开发模式,webpack的配置不尽相同,而且配置起来异常繁琐。所以为了快速搭建前端项目,这些前端框架都推出了各自的项目构建脚手架工具,例如create-react-app以及vue-cli。
    本文将介绍vue-cli的使用和配置过程,方便新手人门参考。

    安装

    安装node

    如果你的电脑未安装node,请去官网下载node安装包并将node安装好。

    设置npm源

    如果你的node npm源还未设置成taobao源,请设置npm源为taobao源(官方源服务器在国外,速度堪忧,切换成国内taobao源镜像)

    // 查看npm源
    npm config get registry
    // 设置为taobao源
    npm config set registry http://registry.npm.taobao.org/
    

    安装Webpack Dev Server

    //   i为install首字母   -g为全局安装
    npm i webpack-dev-server -g
    

    全局安装vue-cli

    // 可能需要sudo权限
    // sudo npm install -g vue-cli
    npm install -g vue-cli
    

    完成vue-cli的安装,便可以使用相关的命令去构建项目了。

    使用

    命令行使用

    使用vue-cli创建项目:

    vue init webpack vue-sample
    

    其中vue-sample是我们所起的项目名,命名执行后,会进入项目初始化阶段。类似于npm init,需要开发者根据命令行的相关提示设置项目初始化信息,以mac系统下为例:


    新建项目
    • ? Project name vue-sample 设置项目名,可以直接按回车使用默认项目名vue-demo
    • ? Project description A Vue.js project 设置项目描述,可以直接按回车使用默认描述
    • ? Author xxxxx <xxxxxxxxxx>设置作者信息,或直接回车使用默认值
    ❯ Runtime + Compiler: recommended for most users
      Runtime-only: about 6KB lighter min+gzip, but templates (or any Vue-specific H
    TML) are ONLY allowed in .vue files - render functions are required elsewhere  
    
    • Runtime + Compiler:推荐的方案,包括运行和编译模块
    • Runtime-only:仅运行模块,更轻量级,但是在.vue文件外不允许使用templates(需使用render函数来取代对应的template属性设置)
    • ? Install vue-router? (Y/n) 是否安装vue-router如果你的项目是单页应用并且包含多个细分页面,建议安装。如果你的页面只有一个或者多个不相干的页面,则不需要安装。
    • ? Use ESLint to lint your code? (Y/n) 是否使用ESLint来规范你的代码?ESLint是一款js代码风格管理工具,用于统一和规范代码风格,对于js这种脚本语言来说,良好规范的代码风格有助于提高代码的可读性和组织性,建议按照个人习惯使用。

    选择使用ESLint之后,会出现ESLint预设配置选择:

    • ? Set up unit tests (Y/n) 是否安装单元测试框架。
    ? Should we run `npm install` for you after the project has been created? (recom
    mended) (Use arrow keys)
    ❯ Yes, use NPM
      Yes, use Yarn
      No, I will handle that myself
    

    在项目创建之后是否执行 npm install 命令安装项目依赖,可以选择使用npm或者yarn(需使用npm全局安装yarn命令并设置yarn源为淘宝源)命令或者后续自己执行相关命令安装依赖,建议使用npm

    注意:若项目中在.vue文件中使用了less来书写style模块(lang=less)或者引用了.less样式文件,需要手动安装less以及less-loader模块后页面才会正常运行,sass同理。运行 npm i less less-loader -D 命令快捷安装。

    //  -D是 --save-dev的简写
    npm i less less-loader -D
    

    项目结构梳理

    初始目录结构

    项目初始目录结构如下:


    初始化项目结构

    下面对项目结构做下简单介绍:

    • build: 提供webpack各环境配置方案、webpack构建和打包任务脚本(通过npm run build命令启动)
    • config:webpack、webpack-dev-server相关的配置参数
    • node_modules:node模块文件夹,通过npm安装的模块会存放在这里
    • src:项目开发文件夹,我们写的代码基本都放在这里
    • static:静态资源文件夹
    • .babelrc:babel配置文件
    • .editorconfig:编辑器配置文件
    • .gitignore:git忽略文件配置文件,相关文件将不会被放入到git仓库中
    • .postcssrc.js:postcss配置文件,用于启用相关的postcss插件
    • index.html:HtmlWebpackPlugin使用的html模板文件,用于自动生成相应的html模板
    • package.json:项目npm配置文件,主要记录项目基本信息、引用的npm模块信息、script命令列表等
    • README.md:项目说明MarkDown文件

    注意:项目中的静态资源文件有两个地方可以存放,分别是static文件夹和src/assets文件夹,这两个文件夹下的资源在处理上是不同的。具体表现为:

    • assets 目录中的文件会被webpack处理解析为模块依赖,只支持相对路径形式如,background: url(./logo.png)中,"./logo.png" 是相对的资源路径,将由Webpack解析为模块依赖
    • static 目录下的文件并不会被Webpack处理,它们会直接被复制到最终的打包目录(默认是dist/static)下。必须使用绝对路径引用这些文件,这是通过在 config.js 文件中的 build.assetsPublicPath 和 build.assetsSubDirectory 配置来确定的
    src目录结构

    src文件夹内包含:

    • assets文件夹:存放开发中使用到的各类资源文件(如图片、字体、样式等)
    • components文件夹:Vue组件存放文件夹,用于存放开发的vue组件
    • router文件夹:存放vue-router配置模块
    • App.vue:Vue应用根组件
    • main.js:项目入口js文件(webpack entry)
    src目录结构调整
    • 可以在assets文件夹中添加相应的子文件夹来管理相应的资源,如style、img、font等
    • 可以在components文件夹中添加common(常用模块)、page(页面模块)等文件夹来管理相应模块

    常用命令

    npm run dev
    开启webpack-dev-server热重载调试服务器,调试本地页面和代码逻辑

    npm start
    npm run dev命令简写

    npm run build
    执行webpack打包命令,打包生成最终的代码

    相关文章

      网友评论

          本文标题:vue-cli 2搭建前端项目

          本文链接:https://www.haomeiwen.com/subject/jhsckctx.html