如何将数字转换为上标形式（如 ¹²³）

本文介绍在 node.js 中将普通数字字符串高效转换为 unicode 上标字符（如 “123” → “¹²³”）的方法，适用于 discord 机器人昵称设置等场景，提供可直接复用的函数及使用注意事项。

本文介绍在 node.js 中将普通数字字符串高效转换为 unicode 上标字符（如 “123” → “¹²³”）的方法，适用于 discord 机器人昵称设置等场景，提供可直接复用的函数及使用注意事项。

在开发 Discord 机器人（如基于 Discord.js v14）时，常需为用户设置个性化昵称，例如将等级、积分或序号以视觉更突出的上标形式呈现（如 Lv.²⁷ 或 Member¹⁰⁰）。这类“上标数字”并非通过 CSS 或富文本实现，而是直接使用 Unicode 标准中的上标数字字符（Superscript Digits），它们是独立的 Unicode 码点（如 U+2070 对应 ⁰，U+00B9 对应 ¹，U+00B2 对应 ²，U+00B3 对应 ³），可像普通字符串一样拼接、发送，完全兼容 Discord 的昵称字段。

实现的核心思路是：将输入字符串中的每个阿拉伯数字字符（0–9），按映射关系替换为对应的 Unicode 上标字符。JavaScript 提供了简洁高效的方案——利用正则表达式配合 String.prototype.replace() 与回调函数：

const turnDigitsToSuperscript = (input) => {   // 预定义上标数字字符串，索引 0~9 对应 ⁰¹²³⁴⁵⁶⁷⁸⁹   const superscripts = '⁰¹²³⁴⁵⁶⁷⁸⁹';   return String(input).replace(/d/g, (digit) => superscripts[parseInt(digit, 10)]); };  // ✅ 使用示例 console.log(turnDigitsToSuperscript('123'));     // '¹²³' console.log(turnDigitsToSuperscript('Level5'));  // 'Level⁵' console.log(turnDigitsToSuperscript(42));        // '⁴²'（自动转字符串）

? 关键细节说明：

• 正则 /d/g 全局匹配所有数字字符（包括字符串中混杂的数字）；
• String(input) 确保传入数值（如 42）也能安全处理；
• parseInt(digit, 10) 显式指定十进制解析，避免意外进制转换；
• 该函数不修改原字符串，返回全新字符串，符合函数式编程习惯。

在 Discord.js v14 的交互场景中，可直接集成到昵称设置逻辑中：

const { SlashCommandBuilder } = require('@discordjs/builders'); const { turnDigitsToSuperscript } = require('./utils'); // 假设封装在 utils.js  module.exports = {   data: new SlashCommandBuilder()     .setName('setrank')     .addIntegerOption(option =>        option.setName('rank').setDescription('Rank number').setRequired(true)),    async execute(interaction) {     const rank = interaction.options.getInteger('rank');     const user = interaction.options.getMember('user') || interaction.member;      try {       const superscriptRank = turnDigitsToSuperscript(rank);       await user.setNickname(`Rank${superscriptRank} | ${user.displayName}`);       await interaction.reply({ content: `✅ 昵称已更新为: Rank${superscriptRank}`, ephemeral: true });     } catch (error) {       await interaction.reply({ content: '❌ 设置昵称失败，请检查权限或昵称长度', ephemeral: true });     }   } };

⚠️ 注意事项：

• Discord 对昵称长度限制为 32 个 Unicode 字符（非字节），而一个上标数字占 1 个字符，但部分字体渲染可能使其视觉宽度略小，实际使用中无需额外计数；
• 此方法仅转换 ASCII 数字 0–9，不支持负号、小数点或中文数字；如需扩展，可增强正则与映射表（例如添加 ⁻ ⁰ · 等）；
• 所有上标字符均为标准 Unicode，兼容绝大多数现代终端、客户端和 API，无需额外依赖或字体支持；
• 避免对用户可控输入（如昵称原文）未经清洗直接转换，以防注入无效字符（本函数本身已做类型安全防护）。

总结来说，turnDigitsToSuperscript 是一个轻量、可靠、开箱即用的工具函数。它将底层 Unicode 映射逻辑封装为一行核心逻辑，兼顾可读性与健壮性，是 Discord 机器人、CLI 工具或任何需要美化数字显示的 Node.js 项目的实用补充。