wanghuipeng / vue-ssr

基于vue-ssr搭建的一套node服务端渲染工作流

vue-ssr node 服务端渲染工作流

react 版本服务端渲染 跳转

解决问题

• 【手机端首屏渲染问题】
• 【SEO 解决搜索引擎抓取问题】
• 【提高页面渲染性能】

统一的文件系统结构

• 项目整体目录结构

├── LICENSE
├── README.md
├── build
│   ├── setup-dev-server.js
│   ├── vue-loader.config.js
│   ├── webpack.base.config.js
│   ├── webpack.client.config.js
│   └── webpack.server.config.js
├── log
│   ├── err.log
│   └── out.log
├── package.json
├── pmlog.json
├── server.js
└── src
    ├── App.vue
    ├── app.js
    ├── assets
    │   ├── images
    │   ├── style
    │   │   └── css.less
    │   └── views
    │       └── index.css
    ├── components
    │   ├── Banner.vue
    │   ├── BottomNav.vue
    │   ├── FloorOne.vue
    │   └── Header.vue
    ├── entry-client.js
    ├── entry-server.js
    ├── index.template.html
    ├── public
    │   ├── conf.js
    │   └── utils
    │       ├── api.js
    │       └── confUtils.js
    ├── router
    │   └── index.js
    ├── static
    │   ├── img
    │   │   └── favicon.ico
    │   └── js
    │       └── flexible.js
    ├── store
    │   ├── actions.js
    │   ├── getters.js
    │   ├── index.js
    │   ├── modules
    │   │   └── Home.js
    │   ├── mutationtypes.js
    │   └── state.js
    └── views
        └── index
            ├── conf.js
            ├── index.vue
            ├── mock.js
            └── service.js

统一的职责划分

• views 文件夹下分模块文件，模块文件下下又分模块本身的.vue 文件（模版文件），index.js 文件（后台数据交互文件），mock.js（本模块的 mock 假数据），conf.js（配置本模块一些参数，请求路径，模块名称等信息）
• components 公共组件文件夹
• router 主要存放前端路由配置文件，写法规范按照 vue-router 官方例子即可。
• store 主要是存放共享状态文件，里面包含 action.js,getter.js,mutationtype.js 等，后期会根据模块再细分这些。
• public 主要存放公共组件代码和项目使用的公共文件代码，例如后期我们将 axios 封装成公共的 api 库文件等等
• static 文件夹代表静态文件，不会被 webpack 打包的
• pmlog.json 集成了 pm2 监控命令
• app.js 是项目入口文件
• App.vue 是项目入口文件
• entry-client 和 entry-server 分别是客户端入口文件和服务端的入口文件
• index.template.html 是整个项目的模版文件
• server.js 服务端启动服务的入口文件

开发自动化

• 自动化搭建本地研发环境，快速响应文件更改并自动刷新浏览器。
• 自动化编译 ES6 或 CommonJS 标准的 JS 代码，自动化生成 source map 便于浏览器端调试。
• 自动化编译 SASS/LESS => CSS 文件，自动化添加 CSS3 的各种浏览器前缀。
• 服务端使用 express，前端使用 webpack 自动化构建打包。

安装使用

安装

• Mac 系统推荐使用 iterm2 及 oh my zsh
• 类 Unix 系统，请打开任意终端输入命令执行。
• Windows 用户请先安装 git，然后在 Git Bash 下执行命令

安装 Node 和 NPM

• 详细过程参考官网 https://nodejs.org (中文网站 http://nodejs.cn/)
• 支持所有 Node 的发行版本，建议使用最新稳定版 6.x 。
• Ubuntu 用户使用 apt-get 安装 node 后，安装的程序名叫 nodejs，需要软链成 node
• Windows 用户安装完成后需要在 CMD 下确认是否能执行 node 和 npm

全局安装 webpack 最新版本

npm install webpack -g

运行 Demo 示例项目

安装 NPM 包

• 进入项目 目录执行以下命令

npm install

运行 Demo 示例

• 在项目目录下执行

// 打包命令
npm run build

// production模式下启动服务
npm run start

// dev模式下启动服务
npm run dev

npm run dev 启动服务路径http://localhost:6180

添加 mock 假数据测试

// /views/index/mock.js
GET: {
    "code": 200,
    "data": [
        {
        name: '推荐',
        type: 0
        },
        {
        name: '居家',
        type: 1
        },
        {
        name: '餐厨',
        type: 2
        },
        {
        name: '服装',
        type: 3
        },
        {
        name: '电器',
        type: 4
        },
        {
        name: '洗护',
        type: 5
        },
        {
        name: '杂货',
        type: 6
        }
    ]
    },
    GETBOTTOM: {
    "code": 200,
    "data": [
        {
        href: '/',
        value: '首页',
        type: 'index'
        },
        {
        href: '/',
        value: '识物',
        type: 'topic'
        },
        {
        href: '/',
        value: '分类',
        type: 'cate'
        },
        {
        href: '/',
        value: '购物车',
        type: 'cart'
        },
        {
        href: '/',
        value: '个人',
        type: 'ucenter'
        }
    ]
    }

// views/index.vue
serviceGet() {
    Service.get().then((data) => {
        this.headNavData = data;
    })
    Service.getBottom().then((data) => {
        this.botNavData = data;
    })
}

service workers 配置

// webpack.cliemt.config.js
if (process.env.NODE_ENV === 'production') {
  config.plugins.push(
    // auto generate service worker
    new SWPrecachePlugin({
      cacheId: 'ga-vue',
      filename: 'service-worker.js',
      minify: true,
      dontCacheBustUrlsMatching: /\.\w{8}\./,
      staticFileGlobsIgnorePatterns: [/\.map$/, /\.json$/]
    })
  )
}

// entry-client.js
if ('serviceWorker' in navigator) {
  console.log('SW present !!! ')
  navigator.serviceWorker
    .register('/service-worker.js', {
      //scope: '/toto/'
    })
    .then(function(registration) {
      console.log('Service worker registered : ', registration.scope)
    })
    .catch(function(err) {
      console.log('Service worker registration failed : ', err)
    })
}

发布部署

node 服务器通过 express/koa 搭建环境，通过 pm2 启动端口服务，一般会在项目目录新建 bin 文件夹，然后新建相应的 sh 脚本命令来启动 node 服务。

以下是最终效果截图