Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wqzwh/vue-ssr
基于vue-ssr搭建的一套node服务端渲染工作流
https://github.com/wqzwh/vue-ssr
ssr vue webpack
Last synced: about 2 months ago
JSON representation
基于vue-ssr搭建的一套node服务端渲染工作流
- Host: GitHub
- URL: https://github.com/wqzwh/vue-ssr
- Owner: wqzwh
- License: mit
- Created: 2017-08-09T11:09:07.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-11T01:07:51.000Z (almost 2 years ago)
- Last Synced: 2024-04-09T12:01:22.660Z (5 months ago)
- Topics: ssr, vue, webpack
- Language: CSS
- Homepage:
- Size: 1.49 MB
- Stars: 79
- Watchers: 3
- Forks: 18
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vue-ssr node 服务端渲染工作流
## react 版本服务端渲染 [跳转](https://github.com/wqzwh/react-ssr)
## 解决问题
- 【手机端首屏渲染问题】
- 【SEO 解决搜索引擎抓取问题】
- 【提高页面渲染性能】
### 统一的文件系统结构
- 项目整体目录结构
```bash
├── 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](http://iterm2.com/) 及 [oh my zsh](http://ohmyz.sh/)
- 类 Unix 系统，请打开任意终端输入命令执行。
- Windows 用户请先安装 [git](http://git-scm.com/)，然后在 [Git Bash](http://git-for-windows.github.io/) 下执行命令
#### 安装 Node 和 NPM
- 详细过程参考官网 https://nodejs.org (中文网站 http://nodejs.cn/)
- 支持所有 Node 的发行版本，建议使用最新稳定版 6.x 。
- Ubuntu 用户使用 `apt-get` 安装 node 后，安装的程序名叫 `nodejs`，需要软链成 `node`
- Windows 用户安装完成后需要在 CMD 下确认是否能执行 node 和 npm
#### 全局安装 webpack 最新版本
```bash
npm install webpack -g
```
### 运行 Demo 示例项目
#### 安装 NPM 包
- 进入项目 目录执行以下命令
```bash
npm install
```
#### 运行 Demo 示例
- 在项目目录下执行
```bash
// 打包命令
npm run build
```
```bash
// production模式下启动服务
npm run start
```
```bash
// dev模式下启动服务
npm run dev
```
npm run dev 启动服务路径http://localhost:6180
### 添加 mock 假数据测试
```javascript
// /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'
}
]
}
```
```javascript
// views/index.vue
serviceGet() {
Service.get().then((data) => {
this.headNavData = data;
})
Service.getBottom().then((data) => {
this.botNavData = data;
})
}
```
### service workers 配置
```javascript
// 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$/]
})
)
}
```
```javascript
// 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 服务。
以下是最终效果截图
