三个文件就够了。index.html 只放一个 canvas 元素和一行 script 标签把 game.js 拉进来;style.css 负责让画布居中、去掉页面默认边距;game.js 装下全部逻辑。

    别碰引擎和打包工具。Phaser 这类框架确实省事,但它把循环、碰撞都藏起来了,你学不到底层。Webpack 更没必要,一个文件直接双击就能跑,读者才愿意跟着试。

    翻车现场:我见过有人把整本书拆成二十个模块互相 import,结果读者卡在环境配置,游戏一行没写。还有些人图省事把 JS 内联在页面里,改一行就得刷新整个页面,调试起来很别扭。

    分开之后职责很清楚:页面只管结构和挂载,样式只管显示尺寸和外观,逻辑全在 game.js。哪天要加个排行榜,也就是 game.js 里多接一个函数的事,不用动其它两个文件。

    // game.js 开头:拿画布、取上下文、登记主循环
    const canvas = document.getElementById('game');
    const ctx = canvas.getContext('2d');
    const W = canvas.width, H = canvas.height;
    requestAnimationFrame(loop);
    

    结构越简单,读者越容易从头跑到尾。之后想加功能,都在 game.js 里接一段就行。