最近有个小游戏很火，叫 Wordle，是个填字游戏，推上随处可见相关分享。各种衍生版也层出不穷。有位朋友让我帮他复刻，反正过年，闲着也是闲着，我就尝试用标题里的新技术栈帮他写了一个。现在已经上线了，对填字游戏感兴趣的同学可以试试：
My Wordle（特色：1. 支持自定义单词；2. 5～9字母；3. 无限模式，可以一直玩。）
这篇文章简单记录一些开发过程和经验。
0. 创建 vite 项目
Terminal
npm init vite@latest
接下来按照提示选择喜欢的配置即可。
小配置下 vite.config.js，添加 @ 别名：
vite.config.js
export default defineConfig(({command, mode}) => {
const isDev = command === 'serve';
return {
server: {
host: true,
},
plugins: [
vue(),
],
resolve: {
alias: {
'@': resolve(__dirname, './src'),
},
},
};
});
注意，上面的配置文件虽然是 ESM，但实际上仍然在 CommonJS 环境里执行，所以有 __dirname。
然后安装依赖：pnpm i。
最后 npm run dev 即可启动开发服务器进行开发。Vite 真是快，空项目 100ms 就启动了。
1. 安装+配置 Tailwind CSS
Terminal
pnpm i -D tailwindcss postcss autoprefixer
npx tailwindcss init -p
配置 tailwind.config.js
tailwind.config.js
module.exports = {
content: [
"./index.html",
"./src/**/*.{vue,js,ts,jsx,tsx,pug}",
],
theme: {
extend: {},
},
plugins: [],
safelist: [
{
pattern: /w-\d+\/\d+/,
},
{
pattern: /grid-cols-[5-9]/,
},
],
}
接下来创建 CSS 入口文件：./src/style/index.css：
index.css
@tailwind base;
@tailwind components;
@tailwind utilities;
最后在入口文件里引用它即可：
main.ts
import { createApp } from 'vue'
import App from './App.vue'
import './index.css'
createApp(App).mount('#app')
2. 配置 TypeScript
默认的 TypeScript 就挺好使，这里简单配一下 @ 别名即可：
tsconfig.json
{
"compilerOptions": {
"paths": {
"@/*": [
"./src/*"
]
}
},
}
为开发方便，还需要装一些类型定义：
Terminal
pnpm i @types/gtag.js @types/node -D
3. 配置 eslint
安装所需依赖：
Terminal
pnpm i -D @typescript-eslint/eslint-plugin @typescript-eslint/parser @vue/eslint-config-typescript eslint eslint-plugin-babel eslint-plugin-vue
配置 .eslintrc.js：
.eslintrc.js
module.exports = {
"env": {
"browser": true,
"es2021": true,
"node": true
},
parser: "vue-eslint-parser",
parserOptions: {
parser: "@typescript-eslint/parser",
sourceType: 'module',
ecmaVersion: 'latest',
},
extends: [
'eslint:recommended',
'plugin:vue/vue3-recommended',
'@vue/typescript/recommended',
],
plugins: [
'babel',
'vue',
],
globals: {
withDefaults: true,
defineProps: true,
defineEmits: true,
defineExpose: true,
Nullable: true,
Timeout: true,
$root: true,
},
"rules": {
'@typescript-eslint/no-unused-vars': 0,
'@typescript-eslint/ban-ts-comment': 0,
'@typescript-eslint/no-non-null-assertion': 0,
},
}
4. 拆包与懒加载
Wordle 游戏需要用到词库，5个字母的词库 200+KB，6789的词库都是 300KB，全部放到一起加载太浪费，所以计划按需加载。另外，词库几乎是不变的，但业务逻辑是多变的，如果不拆包的话，每次业务逻辑变更后，用户都要重复下载好几百 KB 的词库，所以要做拆包与懒加载。
拆包方面，vite build 是基于 rollup 实现的，所以要按照 rollup 的要求，用 rollupOptions 来配置：
vite.config.js
export default defineConfig(({command, mode}) => {
return {
....
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (/[sf]\d\.txt\?raw$/.test(id)) {
return 'dict';
} else if (/share\d\.txt\?raw$/.test(id)) {
return 'share';
} else if (id.includes('node_modules')) {
return 'vendor';
}
},
},
},
},
};
});
默认只加载高频词，全量词库会在页面准备就绪后，通过 fetch API 异步加载。
5. 添加骨架屏
网页里有个静态 footer，因为 CSS 文件加载需要一些时间，所以会先渲染出来，然后再挪到正确的位置，造成抖动。这里有两个选择：1. 隐藏 footer，或挪到 vue 里；2. 添加加载中样式。我选择在（2）上再发展一点，做骨架屏。
我的思路是：
- 在
<div id="app"></div> 里填充只有标题的 header 和填字格 - 拆分
tailwind.css，分成- 只包含 reset 和 index.html 所需的 inline css
- 包含全部业务样式的外部 css 文件
- 编写脚本，build 时往 index.html 里塞入填字格，并把 inline css 写入网页
<head> 里
实现方面，首先编辑 vite.config.js：
vite.config.js
export default defineConfig(({command, mode}) => {
const tailwind = command === 'serve' ? 'tailwind-sketch.css' : 'tailwind.css';
return {
resolve: {
alias: {
'@tailwindcss': resolve(__dirname, './src/style/' + tailwind),
},
},
};
});
我从 tailwind.css 里移除了 @tailwind base，即 reset 部分。这部分会被 inline 到 index.html 里。然后修改 tailwind.config.js，加入根据环境判断是否需要分析 index.html 的逻辑：
const isDev = process.env.NODE_ENV ==='development';
module.exports = {
content: [
'./src/App.{pug,vue,ts,tsx}',
'./src/**/*.{vue,js,jsx,ts,tsx,pug}',
].concat(isDev ? './index.html' : []),
theme: {
extend: {},
},
plugins: [],
}
接着修改 build 脚本，增加编译 inline css 和注入功能：
package.json
{
"name": "aw-woodle-game",
"version": "0.4.0",
"scripts": {
"build": "vue-tsc --noEmit && vite build && npm run build:sketch && npm run build:sketch2 && build/build.js",
"build:sketch": "tailwind -i src/style/tailwind-sketch.css -o tmp/sketch.css --content index.html --config build/tailwind.config.sketch.js --minify",
"build:sketch2": "stylus --include-css --compress < src/style/sketch.styl > tmp/sketch2.css",
},
}
6. 总结
最终我使用这套工具链完成了整个产品的开发。不过仍然有一些问题未解：
- Vite 开发环境与构建环境其实是两套工具链，所以能过 dev，未必能过 build，尤其是 TypeScript，会有很多差异。不过只要耐心调试一番，也不难搞。
- 不知道是否跟我用 pug 有关，Tailwind 总是慢一拍。即我改了模版，html 变了，但对应的样式并没有出来；过一会儿，就出来了。于是我要么继续改，期待后面它会加上来；要么只有手动刷新。
- build 时，rollup 会把 css 放在
<head> 里面，导致浏览器认为这段 CSS 是关键内容，加载完之后才进行第一次渲染（FCP），使得我的骨架屏失效，所以要手动把它挪到 <html> 的最后。（当然在 GA 等代码的前面）
最终的 Lighthouse 得分比较喜人，贴一下：
（更多…）
