本文介绍在 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 项目的实用补充。
