
3步搞定五子棋游戏在线玩 避坑实战项目
版本升级后 API 全变了,以前能跑的 Canvas 绘图代码现在直接报错,这种痛谁懂?别急着翻文档,咱们直接上实战项目。今天不整虚的,用原生 JavaScript 加 Canvas,从零手写一个五子棋游戏在线玩的小程序。不用任何框架,不用 npm install,打开浏览器就能跑。这不仅是练手,更是理解前端交互逻辑的最佳切入点。很多初学者卡在“想做一个网页游戏”这一步,其实核心就三块:棋盘绘制、落子逻辑、胜负判断。搞定这三块,你的第一个五子棋游戏在线玩作品就诞生了。
1. 项目目标:为什么选五子棋
做前端实战项目,选什么题材很关键。太简单的没成就感,太复杂的劝退。五子棋是最佳平衡点。
为什么是它?
规则简单:黑白交替,连五即胜。不需要复杂的 AI 算法(初期),适合入门。
交互直观:鼠标点哪里,棋子落哪里。视觉反馈即时,容易建立成就感。
技术覆盖全:涉及 DOM 操作、Canvas 绘制、事件监听、状态管理。这些是前端基本功。
我们要实现的功能清单:
静态棋盘:15x15 的标准棋盘,带坐标线。
动态落子:鼠标点击格子,生成黑/白棋子,交替进行。
胜负判定:实时检测横、竖、斜四个方向是否有五子连珠。
重开一局:清空棋盘,重置状态。
注意:这里我们不写 AI。AI 算法(如极小极大算法)是进阶内容,会分散初学者对基础逻辑的注意力。先把基础打牢,再去挑战 AI。
2. 目录结构:极简主义
既然要在线玩,我们就用单文件策略,方便部署和调试。后续如果要扩展,再拆分模块。
gomoku-online/
├── index.html # 主页面,包含 HTML 结构
├── style.css # 样式文件,美化界面
└── script.js # 核心逻辑,所有 JS 代码
index.html 核心结构:
!DOCTYPE html
html lang=zh-CN
head
meta charset=UTF-8
title五子棋游戏在线玩/title
link rel=stylesheet href=style.css
/head
body
div class=container
h1五子棋游戏在线玩/h1
p id=status当前玩家:黑棋/p
button id=restartBtn重开一局/button
!-- Canvas 容器,固定宽高 --
canvas id=board width=600 height=600/canvas
/div
script src=script.js/script
/body
/html
style.css 关键点:
居中布局,让棋盘看起来更专业。
背景色设为木色或浅灰,模拟真实棋盘质感。
按钮悬停效果,提升交互体验。
3. 核心代码实现:逐行拆解
这部分是实战项目的核心。我们分三步走:画棋盘、处理点击、判断胜负。
3.1 初始化 Canvas 与棋盘绘制
Canvas 是 HTML5 的核心绘图 API。很多老项目用 getContext('2d') 时,因为浏览器版本差异或上下文丢失,导致 fillRect 等方法报错。Stack Overflow 上有个高赞回答指出,必须在 Canvas 尺寸确定后再获取 context,否则绘图坐标会偏移。
const canvas = document.getElementById('board');
const ctx = canvas.getContext('2d');
// 定义常量,方便后续修改
const BOARD_SIZE = 15; // 15路棋盘
const CELL_SIZE = 40; // 每格40px
const MARGIN = 20; // 边距
let currentPlayer = 'black'; // 当前玩家,初始黑棋
let boardState = []; // 二维数组存储棋盘状态,0:空 1:黑 2:白
// 初始化棋盘状态
function initBoard() {
boardState = Array(BOARD_SIZE).fill().map(() = Array(BOARD_SIZE).fill(0));
currentPlayer = 'black';
document.getElementById('status').innerText = '当前玩家:黑棋';
drawBoard();
}
// 绘制棋盘网格
function drawBoard() {
// 清空画布
ctx.clearRect(0, 0, canvas.width, canvas.height);
// 画背景
ctx.fillStyle = '#DEB887'; // 木色背景
ctx.fillRect(0, 0, canvas.width, canvas.height);
ctx.strokeStyle = '#000';
ctx.lineWidth = 1;
// 画横线
for (let i = 0; i BOARD_SIZE; i++) {
ctx.beginPath();
ctx.moveTo(MARGIN, MARGIN + i * CELL_SIZE);
ctx.lineTo(MARGIN + (BOARD_SIZE - 1) * CELL_SIZE, MARGIN + i * CELL_SIZE);
ctx.stroke();
}
// 画竖线
for (let j = 0; j BOARD_SIZE; j++) {
ctx.beginPath();
ctx.moveTo(MARGIN + j * CELL_SIZE, MARGIN);
ctx.lineTo(MARGIN + j * CELL_SIZE, MARGIN + (BOARD_SIZE - 1) * CELL_SIZE);
ctx.stroke();
}
// 画星位(天元等,可选,增加专业感)
drawStarPoints();
}
关键点解析:
clearRect:每次重绘前必须清空,否则棋子会重叠。
坐标计算:MARGIN + i * CELL_SIZE 是核心公式。行号 i 和列号 j 对应像素位置。
beginPath 和 stroke:这是 Canvas 绘制的标准流程,忘记 beginPath 会导致线条粘连。
3.2 事件监听与落子逻辑
鼠标点击 Canvas 时,我们需要计算点击位置对应的是哪个格子。这里有个常见坑:Canvas 的坐标原点在左上角,但鼠标事件的 clientX/Y 是相对于视口的。必须减去 Canvas 本身的偏移量。
canvas.addEventListener('click', function(e) {
// 获取点击位置相对于 Canvas 内部的坐标
const rect = canvas.getBoundingClientRect();
const x = e.clientX - rect.left;
const y = e.clientY - rect.top;
// 计算行列索引
// 注意:要四舍五入到最近的格子中心,而不是直接除以
const col = Math.round((x - MARGIN) / CELL_SIZE);
const row = Math.round((y - MARGIN) / CELL_SIZE);
// 边界检查
if (col 0 || col = BOARD_SIZE || row 0 || row = BOARD_SIZE) {
return; // 点击了棋盘外
}
// 检查该位置是否已有棋子
if (boardState[row][col] !== 0) {
return; // 已有棋子,忽略点击
}
// 落子
boardState[row][col] = (currentPlayer === 'black' ? 1 : 2);
// 重绘整个棋盘(包含新棋子)
drawBoard();
drawPieces();
// 判断胜负
if (checkWin(row, col, currentPlayer)) {
document.getElementById('status').innerText =
`${currentPlayer === 'black' ? '黑' : '白'}棋获胜!`;
return;
}
// 切换玩家
currentPlayer = currentPlayer === 'black' ? 'white' : 'black';
document.getElementById('status').innerText =
`当前玩家:${currentPlayer === 'black' ? '黑' : '白'}棋`;
});
避坑指南:
Math.round 很重要。如果你用 Math.floor,点击格子边缘右侧时,可能会被算到下一格,体验极差。
不要只画新棋子。drawPieces 遍历整个 boardState 重新画所有棋子,这样逻辑最简单,性能对于 15x15 的棋盘也完全足够。
3.3 棋子绘制与胜负判断
drawPieces 函数:
function drawPieces() {
for (let i = 0; i BOARD_SIZE; i++) {
for (let j = 0; j BOARD_SIZE; j++) {
if (boardState[i][j] !== 0) {
const x = MARGIN + j * CELL_SIZE;
const y = MARGIN + i * CELL_SIZE;
ctx.beginPath();
// 画圆,半径略小于格子一半
ctx.arc(x, y, CELL_SIZE * 0.4, 0, Math.PI * 2);
ctx.fillStyle = (boardState[i][j] === 1) ? '#000' : '#FFF';
ctx.fill();
// 加个边框,让白子在浅色背景上更清晰
ctx.strokeStyle = '#000';
ctx.stroke();
}
}
}
}
checkWin 函数:核心算法
这是五子棋游戏在线玩逻辑中最难的部分。我们需要检查以 (row, col) 为中心的四个方向:横、竖、左斜、右斜。
function checkWin(row, col, player) {
const directions = [
[0, 1], // 横向
[1, 0], // 纵向
[1, 1], // 右斜
[1, -1] // 左斜
];
for (const [dx, dy] of directions) {
let count = 1; // 包含当前点
// 正向延伸
for (let i = 1; i 5; i++) {
const nr = row + i * dx;
const nc = col + i * dy;
if (nr 0 || nr = BOARD_SIZE || nc 0 || nc = BOARD_SIZE) break;
if (boardState[nr][nc] === player) count++;
else break;
}
// 反向延伸
for (let i = 1; i 5; i++) {
const nr = row - i * dx;
const nc = col - i * dy;
if (nr 0 || nr = BOARD_SIZE || nc 0 || nc = BOARD_SIZE) break;
if (boardState[nr][nc] === player) count++;
else break;
}
if (count = 5) return true;
}
return false;
}
逻辑详解:
我们不需要遍历整个棋盘,只需要以最新落子点为中心向四周探测。效率极高。
dx 和 dy 定义方向向量。例如 [1, 0] 表示向下走一步。
双向探测:因为五子连珠可能跨越中心点,比如 XXXOXXX 这种情况虽然不合法,但逻辑上我们需要确认连续长度。
4. 运行与测试:如何验证你的代码
代码写完了,怎么知道它是对的?
本地运行:
安装 Live Server 插件(VS Code 用户)。
右键 index.html,选择 Open with Live Server。
浏览器自动打开 http://127.0.0.1:5500。
测试用例:
正常落子:点击中心,出现黑子。再点旁边,出现白子。状态栏文字切换正确。
重复点击:点击已有棋子的位置,无反应,不报错。
边界点击:点击棋盘最外圈线条,能正确落子。点击画布空白处,无反应。
胜负测试:
手动摆出横向五子,点击最后一子,应提示“黑棋获胜”。
手动摆出竖向五子,测试通过。
摆出“四子一断”,不应判定获胜。
重开功能:点击“重开一局”,棋盘清空,状态变回黑棋。
常见 Bug 排查:
棋子位置偏移:检查 MARGIN 和 CELL_SIZE 是否一致。Canvas 的 width 属性必须与 CSS 设置的宽度一致,否则坐标系会缩放错乱。
点击无效:检查 getBoundingClientRect 是否返回了正确的偏移量。如果页面有滚动条,这个值会变化,所以每次点击都要实时获取。
胜负误判:在 checkWin 中加 console.log,打印出探测到的 count 值,手动推演一遍逻辑。
5. 优化扩展:从 Demo 到产品
基础功能跑通后,你的五子棋游戏在线玩项目才算入门。想让它更专业,可以加这些功能:
1. 悔棋功能
维护一个 history 数组,每次落子 push 一个 {row, col, player} 对象。
点击“悔棋”,pop 最后一个状态,修改 boardState,重绘。
注意:悔棋后,当前玩家也要切换回来。
2. 倒计时
使用 setInterval,每 30 秒切换一次玩家或提示超时。
需要在 checkWin 获胜或重开时 clearInterval,防止内存泄漏。
3. 音效
加载 place.mp3,落子时播放。
加载 win.mp3,获胜时播放。
代码:new Audio('place.mp3').play()。注意某些浏览器需要用户交互后才能自动播放声音。
4. 响应式设计
使用 CSS Media Query,在小屏幕上缩小 Canvas 尺寸。
或者使用 transform: scale() 缩放整个容器,保持逻辑坐标不变。
5. 数据持久化
使用 localStorage 保存最佳战绩。
例如:localStorage.setItem('gomoku_wins', count)。
进阶挑战:
简单 AI:实现一个基于“规则”的 AI,优先堵死对方四子,其次做自己的四三。这比随机落子有趣得多,也是面试常问的逻辑题。
WebSocket 联机:使用 Node.js + Socket.io,实现两个浏览器实时对战。这才是真正的“在线玩”,也是实战项目中最具含金量的部分。
6. 小结:从代码到思维
这个项目虽然只有几百行代码,但它涵盖了前端开发的几个核心痛点:
Canvas 坐标映射:像素与逻辑坐标的转换,是图形编程的基础。
状态管理:boardState 是单一数据源,所有渲染都基于它。这是 React/Vue 等框架思想的雏形。
算法思维:胜负判断的方向探测,是典型的滑动窗口或射线追踪思想,在图像处理、游戏开发中随处可见。
很多初学者觉得做游戏难,其实是难在“不知道从哪下手”。只要你把五子棋游戏在线玩这个最小闭环跑通,你就建立了信心。接下来,你可以试着把它部署到 GitHub Pages 或 Vercel 上,分享给朋友玩。当看到别人通过你写的代码下棋时,那种成就感是无与伦比的。
编程不是背 API,而是解决问题。版本升级 API 变了,但逻辑没变。理解了原理,换什么框架、什么语言,你都能快速上手。
这个实战项目只是个开始。你打算给它加什么功能?是联机对战,还是更复杂的 AI?还有什么不懂的?评论区留言挨个回。