关键词:随机分组、团队分队、Fisher-Yates 洗牌算法、纯前端、JavaScript、本地处理
一、背景与需求
在体育课、团建活动、分组讨论、抽奖分配等场景中,经常需要将一组人员随机打散并重新分组。传统的手工分组既耗时又容易带来主观偏好;部分在线分组工具要求上传名单到服务器,隐私难以保证,且多为收费订阅模式。
基于此,我开发了 Toolion 团队随机分组器(项目地址:toolion.cn/team-random…
二、核心功能
| 功能模块 | 说明 |
|---|---|
| 名单输入 | 支持粘贴人名列表,兼容换行、逗号、顿号、分号、空格等多种分隔符 |
| 两种分组模式 | 按组数分组(指定分几组,人数尽量均衡);按每组人数分组(指定每组多少人) |
| 一键随机分组 | 基于 Fisher-Yates 洗牌算法打乱名单,然后按模式切分为多个组 |
| 结果展示 | 以卡片形式展示每组成员,显示组号与人数,支持总人数与各组人数分布统计 |
| 结果复制 | 一键将分组结果复制到剪贴板,支持粘贴到文档或群聊 |
| 重新分组 | 不修改名单的情况下,用同一套算法再次随机打乱并分组 |
| 纯前端本地处理 | 所有计算在浏览器内完成,名单不上传服务器,支持离线运行 |
| 免费无需注册 | 打开页面即可使用,无登录、无订阅、无水印 |
| 深色/浅色主题 | CSS 变量适配深色模式,状态持久化到本地存储 |
三、技术实现
3.1 整体架构
该工具是一个纯前端单页面应用(单 HTML 文件),未引入 Vue/React 等前端框架,全部逻辑使用原生 JavaScript 实现:
浏览器端(纯原生 JavaScript)
├── 输入层:名单文本域、分组模式切换(按组数 / 按每组人数)、分组数量输入
├── 处理层:名单解析 → Fisher-Yates 洗牌 → 按模式切分组
├── 输出层:结果卡片渲染、统计信息(总人数、组数、人数分布)、复制到剪贴板
└── 渲染层:输入面板、结果面板、分组卡片、成员徽章、深色/浅色主题
3.2 名单解析
支持多种分隔符,并兼容英文名字中带空格的情况(如 John Doe 不会被错误拆分):
function parseNames(text) {
if (!text) return [];
// 如果含换行,说明用户是多行输入,此时忽略空格分割,避免 John Doe 被拆开
if (text.indexOf('\n') !== -1) {
return text.split(/[\n,,、;;]+/).map(s => s.trim()).filter(Boolean);
}
// 单行输入时,按标点和空格分割
return text.split(/[\n,,、;;\s]+/).map(s => s.trim()).filter(Boolean);
}
关键点:
- 多行输入优先:只要包含换行符,就只按换行和标点(逗号、顿号、分号、中文标点)分割,忽略空格,避免
John Doe被拆成John和Doe; - 单行输入:按标点和空格均分割,适合
张三、李四、王五或张三 李四 王五这种紧凑输入; - 结果经过
.trim()和.filter(Boolean)过滤,去除空项与纯空格项。
3.3 Fisher-Yates 洗牌算法
核心随机打乱逻辑,使用经典的 Fisher-Yates(Knuth)洗牌算法,保证每种排列等概率出现:
function shuffle(array) {
const arr = [...array];
for (let i = arr.length - 1; i > 0; i--) {
const j = Math.floor(Math.random() * (i + 1));
[arr[i], arr[j]] = [arr[j], arr[i]];
}
return arr;
}
关键点:
- 原数组不变:先复制一份
[...array],再在副本上操作,避免污染原始名单,方便“重新分组”时复用; - 线性时间复杂度:O(n),仅遍历一次,适合几百人以内的名单;
- 等概率性:每次从
[0, i]中随机选一个索引j与位置i交换,保证最终排列均匀随机。
3.4 分组逻辑(两种模式)
洗牌后,根据选定的模式切分为多个组:
模式 1:按组数分组
指定分几组,人数尽量均衡,余数分配给前几个组:
if (mode === 'groups') {
if (value > names.length) {
alert('分组数不能大于总人数(当前 ' + names.length + ' 人)!');
return;
}
const baseSize = Math.floor(shuffled.length / value);
const remainder = shuffled.length % value;
let idx = 0;
for (let i = 0; i < value; i++) {
const size = baseSize + (i < remainder ? 1 : 0);
groups.push(shuffled.slice(idx, idx + size));
idx += size;
}
}
baseSize = Math.floor(n / groups)为每组基础人数;remainder = n % groups为余数,分配给前remainder个组,每组多 1 人;- 例如 25 人分 4 组,结果为 7、6、6、6 人。
模式 2:按每组人数分组
指定每组多少人,按顺序切分,最后一组可能人数不足:
} else {
if (value > names.length) {
groups.push(shuffled.slice()); // 设定人数大于总人数时,只产生一组
} else {
for (let i = 0; i < shuffled.length; i += value) {
groups.push(shuffled.slice(i, i + value));
}
}
}
- 例如 25 人每组 6 人,结果为 6、6、6、6、1 人(共 5 组);
- 若设定人数大于总人数,则所有人进入同一组。
输入校验
let value = parseInt(splitValueInput.value, 10);
if (!isFinite(value) || value < 1) {
value = 1;
splitValueInput.value = value;
}
- 非数字、负数或空值时自动修正为 1,防止
NaN导致空分组; - 按组数模式下,若分组数超过总人数,弹出提示并阻止分组。
3.5 结果渲染与统计
分组完成后,以卡片形式渲染每组成员,并计算统计信息:
function renderResults(groups) {
groupList.innerHTML = '';
let totalMembers = 0;
const sizes = [];
groups.forEach((group, index) => {
totalMembers += group.length;
sizes.push(group.length);
const card = document.createElement('div');
card.className = 'group-card';
const membersHtml = group.map(name =>
'<span class="member-badge">' + escapeHtml(name) + '</span>'
).join('');
card.innerHTML =
'<div class="group-card-header">' +
'第 <span>' + (index + 1) + '</span> 组' +
'<span style="color:var(--ink-mute); font-weight:normal; font-size:13px;">共 ' + group.length + ' 人</span>' +
'</div>' +
'<div class="group-members">' + membersHtml + '</div>';
groupList.appendChild(card);
});
const minSize = Math.min.apply(null, sizes);
const maxSize = Math.max.apply(null, sizes);
let balanceText = '';
if (minSize !== maxSize) {
balanceText = ',各组 ' + minSize + '~' + maxSize + ' 人';
} else {
balanceText = ',各组 ' + minSize + ' 人';
}
resultStats.textContent = '共 ' + totalMembers + ' 人,分为 ' + groups.length + ' 组' + balanceText;
actionGroup.hidden = false;
}
关键点:
- XSS 防护:成员名通过
escapeHtml转义& < > " ',防止名单中包含 HTML 特殊字符导致注入; - 人数分布提示:若各组人数不一致,显示范围(如
7~6 人);若一致,显示固定人数; - 结果复制:遍历所有分组卡片,按
第 N 组:名字、名字、名字格式拼接文本,优先使用navigator.clipboard.writeText,不支持时降级为隐藏textarea+document.execCommand('copy')。
3.6 模式切换与界面联动
切换“按组数 / 按每组人数”模式时,自动更新标签、单位和默认值:
splitModeInputs.forEach(radio => {
radio.addEventListener('change', function () {
if (this.value === 'groups') {
splitValueLabel.textContent = '分为多少组?';
splitValueUnit.textContent = '组';
splitValueInput.value = '3';
} else {
splitValueLabel.textContent = '每组多少人?';
splitValueUnit.textContent = '人';
splitValueInput.value = '5';
}
});
});
- 按组数模式默认 3 组;
- 按每组人数模式默认每组 5 人。
3.7 主题适配与深色模式
全站使用 CSS 变量定义配色(--bg, --card, --ink, --brand 等),深色模式下自动切换为深色配色方案,支持跟随系统或手动切换,状态持久化到 localStorage:
:root {
--bg: #f4f6fa;
--card: #fff;
--ink: #14213d;
--brand: #0f4c81;
/* ... */
}
[data-theme="dark"] {
--bg: #0f172a;
--card: #1e293b;
--ink: #f8fafc;
--brand: #38bdf8;
/* ... */
}
四、关键技术挑战与解决方案
| 挑战 | 解决方案 |
|---|---|
| 英文名字带空格被错误拆分 | 多行输入时忽略空格分割,仅按换行与标点分割;单行输入才按空格分割 |
| 输入非法数字导致 NaN 或空分组 | parseInt 后 isFinite 校验,非法时自动修正为 1;按组数超过总人数时弹出提示 |
| 各组人数不均衡 | 按组数模式下,余数分配给前几个组,保证人数差不超过 1 |
| 名单中包含 HTML 特殊字符导致 XSS | 结果渲染前通过 escapeHtml 转义 & < > " ' |
| 复制到剪贴板在非 HTTPS 环境不可用 | navigator.clipboard 优先,失败后降级为 textarea + execCommand('copy') |
| 重新分组时保留原名单 | 洗牌算法对数组副本操作,原名单不变,可反复点击“重新分组” |
| 纯前端无后端依赖 | 所有随机、切分、渲染在浏览器本地完成,名单不上传任何服务器 |
五、使用示例
场景 1:体育课将 30 名学生分成 6 组
- 打开
https://toolion.cn/team-random-group/; - 在名单输入框粘贴 30 名学生姓名,每行一个;
- 选择“按组数”模式,输入分组数
6; - 点击“开始随机分组”,系统将 30 人洗牌后平均分为 6 组,每组 5 人;
- 右侧展示 6 个分组卡片,每组显示组号和成员名单;
- 点击“复制结果”将分组列表复制到群聊或文档。
场景 2:团建活动每组 8 人
- 输入所有参与人员名单;
- 切换到“按每组人数”模式,输入
8; - 点击“开始随机分组”,系统按每组 8 人切分,最后一组可能人数不足;
- 若对结果不满意,点击“重新分组”再次随机打乱,无需重新输入名单。
场景 3:英文名单兼容
名单如下:
John Doe
Jane Smith
Alice Johnson
选择多行输入,系统按换行分割,John Doe 会作为一个完整名字保留,不会被空格拆分。
注意事项:
- 名单数量建议控制在几百人以内,过大名单可能影响页面渲染性能;
- 分组结果仅在本地内存中处理,页面刷新后名单将丢失,重要名单建议先备份;
- 所有数据仅在浏览器本地处理,不上传服务器,适合处理一般人员名单,但涉及敏感个人信息时请谨慎使用。
六、免责声明
本文仅提供技术实现分享,相关工具仅供学习与日常便利使用,不构成任何商业建议。分组结果基于浏览器原生随机数,虽使用 Fisher-Yates 洗牌算法保证等概率性,但不适用于涉及重大法律或财务风险的正式抽签场景,重要场景请使用受监管的抽签方式。所有数据仅在浏览器本地内存中处理,不上传服务器,页面关闭后即从内存释放。
七、总结
本文介绍了一种纯前端实现的团队随机分组方案。核心设计思路:
- 名单智能解析:支持换行、逗号、顿号、分号、空格多种分隔符,兼容英文名字带空格的情况;
- Fisher-Yates 洗牌:O(n) 时间复杂度,等概率随机打乱,原数组不变,支持反复重新分组;
- 两种分组模式:按组数(人数尽量均衡,余数分配给前几组)与按每组人数(最后一组可能不足);
- 输入校验与容错:非法数字自动修正为 1,分组数超过总人数时弹出提示;
- 结果展示与复制:分组卡片展示组号与人数,统计总人数与人数分布,一键复制到剪贴板;
- 隐私优先:全部处理在浏览器本地完成,名单不上传服务器,无需登录,免费使用;
- 主题适配:CSS 变量支持深色/浅色模式切换,状态持久化。
该方案适合需要轻量级、纯前端随机分组能力的场景,可作为前端协作类工具页面的技术参考。
#随机分组 #团队分队 #Fisher-Yates洗牌 #纯前端 #JavaScript #本地处理 #隐私安全 #工具开发 #团建 #体育课分组 #随机抽签