hupoo / vue-cli-template

使用vue-cli 3.x初始化项目

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

vue-cli-3.x 移动端初始模版

  • 脚手架采取3.x,项目已配置vue-router + vuex + eslint + axios + cube-ui + sass(scss)

  • 项目已经配置px转rem,实际pc写设计稿宽度750px除2即可,具体配置可查看.postcssrc.js文件,也可使用scss的px2px()方法转换

安装项目依赖

yarn
or
npm install

启动项目

yarn start
or
npm run start

打包项目

yarn build
or
npm run build

Lints and fixes files

yarn run lint
or
npm run lint

目录文件说明

  • src:项目源码
    • api:存放所有的请求,按页面编写,入口文件为index.js
    • assets:静态文件目录
      1. scss:公用的scss文件,variables.scss无需引入,每个页面都可以直接使用里面的变量
      2. images:项目图片资源,每个页面所需图片在此目录建立对应的目录区分
    • components:公用组件目录,目录命名为大驼峰
      1. 每个组件建立一个文件夹,文件夹名字采用小驼峰,组件入口为:index.vue
    • pages:页面目录
      1. test:示例目录
        • main.vue:页面入口
        • index.js:本页面路由
        • children:子页面
        • components:如果本页面有页面级别的公用组件可在本页面目录新建这个目录存放
    • store:vuex目录
    • utils:项目公用js和公用配置
      1. index.js:项目公用js和需要的配置
      2. axios.js:axios的一些基础配置
    • main.js:vue项目入口文件
    • router.js:项目路由js
    • theme.styl:cube-ui样式变量文件
  • static:不需要经过打包的文件
  • .env.development:开发环境变量文件
  • .env.production:生产环境变量文件
  • .env.test:测试环境变量文件
  • vue.config.js:项目配置文件,具体使用说明可查看https://cli.vuejs.org/zh/config/#vue-config-js

项目规范

  • vuejs风格指南查看
  • eslint风格指南
  • css风格指南查看
  • 滴滴UI官网
  • 所有的缩进都为2个空格
  • 所有文件不能出现中文名
  • css部分
    1. css属性后边统一加一个空格,如:width: 100px;
    2. scss、css的选择器层级最多不要超过5级,建议最多3级,css的class名字采取kebab-case,如:menu-item
  • js部分
    1. js校验采取eslint
    2. 变量多使用letconst定义,常量使用大写加下划线,如BASE_URL
    3. 变量、函数生命采用小驼峰命名法,如:getCode,构造函数采取大驼峰命名法,如:Person
    4. 需要用到第三方库的时候使用import引入
  • 多写注释,js注释采取以下两种形式
    // 单行注释
    
    /**
     * 多行注释
     */
    
    /**
     * 函数封装的注释说明,这个可在编辑器中安装注释文档插件
     * [fn 中括号里面写封装函数的名称加描述]
     * @param  {[type]}   n [这个函数具体有几个参数,多个参数详细列举类型和说明]
     * @return {Function}   [有return写返回描述,无返回即可不写]
     */
    let fn = n => n + 1

About

使用vue-cli 3.x初始化项目


Languages

Language:JavaScript 46.0%Language:CSS 41.2%Language:Vue 7.1%Language:HTML 5.6%