纯前端实现的团队随机分组器技术实现

0 阅读9分钟

关键词:随机分组、团队分队、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 组

  1. 打开 https://toolion.cn/team-random-group/;
  2. 在名单输入框粘贴 30 名学生姓名,每行一个;
  3. 选择“按组数”模式,输入分组数 6;
  4. 点击“开始随机分组”,系统将 30 人洗牌后平均分为 6 组,每组 5 人;
  5. 右侧展示 6 个分组卡片,每组显示组号和成员名单;
  6. 点击“复制结果”将分组列表复制到群聊或文档。

场景 2:团建活动每组 8 人

  1. 输入所有参与人员名单;
  2. 切换到“按每组人数”模式,输入 8;
  3. 点击“开始随机分组”,系统按每组 8 人切分,最后一组可能人数不足;
  4. 若对结果不满意,点击“重新分组”再次随机打乱,无需重新输入名单。

场景 3:英文名单兼容

名单如下:

John Doe
Jane Smith
Alice Johnson

选择多行输入,系统按换行分割,John Doe 会作为一个完整名字保留,不会被空格拆分。

注意事项:

  • 名单数量建议控制在几百人以内,过大名单可能影响页面渲染性能;
  • 分组结果仅在本地内存中处理,页面刷新后名单将丢失,重要名单建议先备份;
  • 所有数据仅在浏览器本地处理,不上传服务器,适合处理一般人员名单,但涉及敏感个人信息时请谨慎使用。

六、免责声明

本文仅提供技术实现分享,相关工具仅供学习与日常便利使用,不构成任何商业建议。分组结果基于浏览器原生随机数,虽使用 Fisher-Yates 洗牌算法保证等概率性,但不适用于涉及重大法律或财务风险的正式抽签场景,重要场景请使用受监管的抽签方式。所有数据仅在浏览器本地内存中处理,不上传服务器,页面关闭后即从内存释放。


七、总结

本文介绍了一种纯前端实现的团队随机分组方案。核心设计思路:

  1. 名单智能解析:支持换行、逗号、顿号、分号、空格多种分隔符,兼容英文名字带空格的情况;
  2. Fisher-Yates 洗牌:O(n) 时间复杂度,等概率随机打乱,原数组不变,支持反复重新分组;
  3. 两种分组模式:按组数(人数尽量均衡,余数分配给前几组)与按每组人数(最后一组可能不足);
  4. 输入校验与容错:非法数字自动修正为 1,分组数超过总人数时弹出提示;
  5. 结果展示与复制:分组卡片展示组号与人数,统计总人数与人数分布,一键复制到剪贴板;
  6. 隐私优先:全部处理在浏览器本地完成,名单不上传服务器,无需登录,免费使用;
  7. 主题适配:CSS 变量支持深色/浅色模式切换,状态持久化。

该方案适合需要轻量级、纯前端随机分组能力的场景,可作为前端协作类工具页面的技术参考。


#随机分组 #团队分队 #Fisher-Yates洗牌 #纯前端 #JavaScript #本地处理 #隐私安全 #工具开发 #团建 #体育课分组 #随机抽签