本站文本内容除另有声明外，转载时均必须注明出处，并遵守CC BY-NC-SA 3.0协议。（转载须知）
本站是中文Minecraft Wiki的镜像站，与Mojang Studios、Weird Gloop没有从属关系。（免责声明）

全站通知：

格式化代码

刷 历
编

阅读

    

2026-08-26更新

    

最新编辑:中文mcwiki机器人

阅读：

  

更新日期：2026-08-26

  

最新编辑：中文mcwiki机器人

来自Minecraft WIKI
跳到导航 跳到搜索
页面贡献者 :
中文Minecraft_Wiki
Disambig gray.svg本条目介绍的是较早的基于§的格式化系统。关于较新的组件系统，请见“文本组件”。
Written Book.png
此条目所介绍的内容已在Minecraft中弃用，可能会在未来版本移除。

这些特性在游戏中已被弃用，目前依旧可用，但不推荐使用。
附加说明：Java版中较新的文本系统和基岩版中的Ore UI不再为格式化代码提供支持。

一本展示了Java版中所有的格式化代码和字符的书

格式化代码（Formatting code），又称颜色代码（Color code），能为文本提供样式信息。

在Minecraft中，可使用分节符号（§）更改文字样式（如颜色、粗体、斜体和下横线等）。

在基岩版中，分节符号能被输入进告示牌、世界名称、重命名栏及聊天栏。

用法

可以在分节符（§）后加某个字符来格式化文本。如果字符是十六进制数字，在客户端里可用于显示文本时切换颜色。

在Java版中，若在格式代码后使用颜色代码，则格式代码的作用范围只能持续到颜色代码之前。例如，§cX§nY会显示为XY，而§nX§cY会显示为XY。因此，当使用颜色代码与格式代码一起使用时，确保首先使用颜色代码，并在更改颜色时重用格式代码。

§a§o§lDedicated Ser§rver§c§k 的效果

在基岩版中，在颜色代码后面的格式代码仍然生效。此外，若使用了混淆代码而没有在行尾使用重置代码，客户端GUI会继续模糊MOTD传过来的文字和版本号显示：

§r可以用于重置文字样式。例如：§nXXX§rYYY会显示为XXXYYY。

颜色代码

不同颜色所对应的颜色代码。使用§+相应数字或字母可以得到对应的颜色。例如，§e会显示为黄色
代码 使用名 称呼 前景色 背景色 等效的ANSI转义序列 备注
R G B Hex R G B Hex
§0 black 黑色 0 0 0
 #000000 		0 0 0
 #000000 		\e[0;30m
§1 dark_blue 深蓝色 0 0 170
 #0000AA 		0 0 42
 #00002A 		\e[0;34m
§2 dark_green 深绿色 0 170 0
 #00AA00 		0 42 0
 #002A00 		\e[0;32m
§3 dark_aqua 暗水蓝色 0 170 170
 #00AAAA 		0 42 42
 #002A2A 		\e[0;36m
§4 dark_red 深红色 170 0 0
 #AA0000 		42 0 0
 #2A0000 		\e[0;31m
§5 dark_purple 深紫色 170 0 170
 #AA00AA 		42 0 42
 #2A002A 		\e[0;35m
§6 gold 金色 255 170 0
 #FFAA00 		64 42 0
 #402A00 		\e[0;33m
§7 gray 灰色 170 170 170
 #AAAAAA 		42 42 42
 #2A2A2A 		\e[0;37m
§8 dark_gray 深灰色 85 85 85
 #555555 		21 21 21
 #151515 		\e[0;90m
§9 blue 蓝色 85 85 255
 #5555FF 		21 21 63
 #15153F 		\e[0;94m
§a green 绿色 85 255 85
 #55FF55 		21 63 21
 #153F15 		\e[0;92m
§b aqua 水蓝色 85 255 255
 #55FFFF 		21 63 63
 #153F3F 		\e[0;96m
§c red 红色 255 85 85
 #FF5555 		63 21 21
 #3F1515 		\e[0;91m
§d light_purple 淡紫色 255 85 255
 #FF55FF 		63 21 63
 #3F153F 		\e[0;95m
§e yellow 黄色 255 255 85
 #FFFF55 		63 63 21
 #3F3F15 		\e[0;93m
§f white 白色 255 255 255
 #FFFFFF 		63 63 63
 #3F3F3F 		\e[0;97m
§g minecoin_gold Minecoin金色 221 214 5
 #DDD605 		55 53 1
 #373501 		\e[0;38;2;221;214;5m [仅BE]
§h material_quartz 石英色 227 212 209
 #E3D4D1 		56 53 52
 #383534 		\e[0;38;2;227;212;209m [仅BE]
§i material_iron 铁锭色 206 202 202
 #CECACA 		51 50 50
 #333232 		\e[0;38;2;206;202;202m [仅BE]
§j material_netherite 下界合金色 68 58 59
 #443A3B 		17 14 14
 #110E0E 		\e[0;38;2;68;58;59m [仅BE]
§m material_redstone 红石色 151 22 7
 #971607 		37 5 1
 #250501 		\e[0;38;2;151;22;7m [仅BE]
§n material_copper 铜锭色 180 104 77
 #B4684D 		45 26 19
 #2D1A13 		\e[0;38;2;180;104;77m [仅BE]
§p material_gold 金锭色 222 177 45
 #DEB12D 		55 44 11
 #372C0B 		\e[0;38;2;222;177;45m [仅BE]
§q material_emerald 绿宝石色 17 160 54
 #11A036 		4 40 13
 #04280D 		\e[0;38;2;17;160;54m [仅BE]
§s material_diamond 钻石色 44 186 168
 #2CBAA8 		11 46 42
 #0B2E2A 		\e[0;38;2;44;186;168m [仅BE]
§t material_lapis 青金石色 33 73 123
 #21497B 		8 18 30
 #08121E 		\e[0;38;2;33;73;123m [仅BE]
§u material_amethyst 紫水晶色 154 92 198
 #9A5CC6 		38 23 49
 #261731 		\e[0;38;2;154;92;198m [仅BE]
§v material_resin 树脂色 235 114 20
 #EB7114 		59 29 5
 #3B1D05 		\e[0;38;2;235;114;20m [仅BE]
§w party_blue_color 组队蓝色 140 179 255
 #8CB3FF 		35 45 64
 #232D40 		\e[0;38;2;140;179;255m [仅BE]

格式代码

代码 使用名 称呼 等效的ANSI转义序列 在基岩版可用 在Java版可用
§k obfuscated 混淆/随机 \e[8m 是 是
§l bold 粗体 \e[1m 是 是
§m strikethrough 删除线 \e[9m 否，已用作颜色代码[1] 是
§n underlined 下划线 \e[4m 否，已用作颜色代码[1] 是
§o italic 斜体 \e[3m 是 是
§r reset 重置 \e[0m 是 是

使用§k循环出现的随机字符会与原有字符的宽度相同。例如，如果是“m”则随机字符都是宽字符，而如果是“i”则都是窄字符。

输入

参见：Unicode输入法
  • 在Windows上，大多数美式/英式英语键盘可以用Alt + NUMPAD2NUMPAD1（在代码页437上为Alt码）或Alt + NUMPAD7NUMPAD8NUMPAD9输入“§”。如果是其他键盘，通常可以用Alt + NUMPAD0NUMPAD1NUMPAD6NUMPAD7输入，或按⊞ Win + .并切换至符号栏输入。
  • 如果在Windows注册表中启用了EnableHexNumpad，也可以用Alt + NUMPAD+ANUMPAD7（“A”是主键盘上的）。因为分节符在Unicode内，所以任何语言下这种方式都可用。
  • 在Mac美式键盘上可以按⌥ Option + 6（也可以按⌥ Option + 5来调出扩展符号），其他键盘则要换成⌥ Option + 00a7。
  • 在Linux上，可以按组合键Composeso或使用Unicode快捷键⎈ Control + ⇧ Shift + u00a7。
  • 在Nintendo Switch上，选择语言（地球图标），滑至底部找到“符号”一栏，“§”在第2页最后一行右侧。
  • 在Android上：
    • Gboard：“§”在“更多符号”中，先点击数字和符号按钮 (?123)，然后点击更多符号按钮 (=\<)。需要注意的是，在早期版本中，“§”在段落符号“¶”下方，需要先按住“¶”再滑动到“§”上。
    • 三星：“§”在“s”下方，需要先按住“s”再滑动到“§”上。
  • 在iOS/iPadOS上：
    • 在iPad上，“§”在“%”下方，需要点击数字/符号按钮，然后向下滑动“%”。
    • 在iPhone上，“§”在“&”下方，需要点击数字/符号按钮，然后按住“&”并滑动到“§”上。
  • 在Xbox上：
    • 在Xbox One上，“§”位于“¶”下方，用Left trigger选中¶时，按住A button直到出现其他选项，将光标移至“§”并用A button选择。
    • 也可以选中标准字母数字键盘上的S键，然后按住A button显示若干个包括“§”的“替代”字符。此方法也适用于Windows 10。

在文本组件中使用时，分节符可以写成\u00A7或\u00a7。

或者也可以从这里复制这个符号（§），并按Ctrl + V（Windows）或⌘ Cmd + V（macOS）粘贴到任何地方。如果不能粘贴，则只能使用文本组件或采用其他方式。

在早期的Java版Classic版本中，用于格式化的符号曾经是&而非§。[2]

兼容性

在基岩版中，分节符可以输入或粘贴在任何能输入文字的地方，且格式化代码可以在几乎所有非Ore UI界面中生效。

在Java版中，目前游戏内唯一能够输入分节符的地方是在告示牌中，必须通过粘贴来输入。

  • 在告示牌中在粘贴文本或点击“完成”时，会对要粘贴的文本或告示牌中的文本进行过滤：若文本中含有分节符且不在文本的末尾，则会将分节符连带着其后的一个字符一同删去。这导致即使在编辑告示牌时成功添加了格式化代码，在编辑完成后其通常也会被删去。
    • 但是，该过滤规则有一个漏洞：若文本中多个分节符连在一起，则只有最后一个分节符会受到影响。因此，可以在告示牌中以§§+任意字符+格式化代码的字符的形式添加格式化代码并最终使其生效（如§§-a会在过滤后变成§a，注意两个分节符需分两次单独粘贴）。[3]
  • 然而，借助辅助程序与编辑器，同样可以把分节符和格式化代码添加到绝大多数文本中。

示例

在Java版1.14以前，以下这些文字可以直接复制粘贴至书与笔中，效果如图所示： 

§nMinecraft Formatting

§r§00 §11 §22 §33
§44 §55 §66 §77
§88 §99 §aa §bb
§cc §dd §ee §ff

§r§0k §kMinecraft
§rl §lMinecraft
§rm §mMinecraft
§rn §nMinecraft
§ro §oMinecraft
§rr §rMinecraft

Minecraft Formatting.gif

编辑器

正在加载互动小工具。如果加载失败，请您刷新本页面并检查JavaScript是否已启用。

用途

server.properties和pack.mcmeta

如果要得到彩色告示牌，或者格式化文本，需输入\u00A7代替§。例如，§5会变成\u00A75。颜色与格式可以结合使用，注意必须在添加颜色之后添加格式。

旧版本兼容性

格式化代码可以在motdserver.properties文件里使用, 但分节符必须被转换为\u00A7。如果直接输入分节符，服务器会自动将其转换为\u00C2\u00A7（§），客户端则会显示为\u00C2错误标记。删除在Motd里的\u00C2代码会引发一连串的问题，这些问题会在一些不兼容的版本上发生。

自定义语言与文字文件

格式化代码可用于语言描述文件中的任意字符前，使得物品名称或界面文本等具有自定义样式。这也被用于end.txt和credits.txt等文字文件中。例如，{"item.minecraft.diamond":"§dDiamond§r"}可以使钻石的名称显示为Diamond。

世界名称

使用外部工具（如NBTExplorer）可以自定义在游戏中世界名称显示的颜色和格式。要修改名称，可以选择level.dat中的LevelName标签。在这个例子中，LevelName设置为：

§1R§2e§3d§4s§5t§6o§7n§8e §9C§ar§be§ca§dt§ei§fo§1n§2s

ColouredLevel.png

除此之外，也可以在存档的文件夹里更改世界名称。然后在选择世界的时候就可以看见指定的颜色效果是否生效。

还可以使用资源包和§来改变世界的名称的颜色，而在创建世界的时候创建者只需要用§设置世界的名称的颜色的标记。

服务器名称

随着如NBTExplorer的第三方工具的使用，服务器名称可以自定义颜色。利用这个功能，可以使用第三方工具编辑Minecraft目录的servers.dat文件来修改Name属性。下面是一个编辑好的例子：

§4§lMinecraft §6§l Server

ColouredServer.png

历史

Java版Classic
0.0.11a加入了格式化代码。[需要验证]
此时使用&来输入格式化代码，支持16种颜色代码而不支持任何样式代码，且实际上未被使用。
0.24_SURVIVAL_TEST分数使用了&e来显示成黄色，这是格式化代码第一次被使用。
Java版Indev
0.3120100206-1437格式化代码现在不再生效，但字符串中的&及其后面的一个字符仍会被删去。[需要验证]
这意味着分数现在为显示白色。
Java版Alpha
v1.0.10现在使用§来输入格式化代码。
但格式化代码仍无法生效，且分数的文本仍未更改，导致分数显示为&e0。
v1.0.12格式化代码现在又可以正常生效了。
更改了颜色代码的文本颜色至与当前一致。
Java版
1.0.0Beta 1.9-pre6加入了随机字符代码：§k。此时随机字符会在所有Mojangles支持的字符中随机选取等宽的。若使用Unifont，则§k不会有任何效果。
1.111w49a§k不再使模糊文本在
 #5555FF和
 #555555两种颜色间变换。
1.2.4加入了其余的格式代码（粗体、删除线、下划线、斜体和重置）。
1.312w17a加入了书与笔，可以在其中粘贴§以使用格式化代码。
1.513w10a现在使用Unifont时，粗体文本（§l）看起来更加正常。[4]
1.8.2pre6现在随机字符（§k）可以在使用Unifont时正常工作了。
1.13pre6现在相同文本的§k的随机字符完全一致。[5]
pre7现在§k的随机字符只会在所有ASCII字符中随机选取。[6]
1.13.118w30a现在§k的随机字符可以在所有Unifont支持的字符中随机选取了。
1.1418w43a现在在书与笔中粘贴文本时会被过滤（见上文）。
在书与笔中使用格式化文本会导致光标不对齐。[7]
18w43c现在完全无法在书与笔中粘贴或输入§，这意味着格式化代码在书与笔中不再可用。
1.1620w17a现在可以在书与笔和告示牌中粘贴§了，但会被过滤。
任何文本中的分节符§不再显示，即使未组成有效的格式化代码（格式化代码本身仍然能够正常生效）。
1.1721w17a现在随机字符（§k）后面的“i”不再会显示为i、!或|，而是和它所占位置大小相同的字符。
1.21.625w18a现在又无法在书与笔中粘贴或输入§了。
1.21.925w36a行为准则文件不再支持格式化代码。
携带版Alpha
0.11.0build 1加入了格式化代码。
基岩版
1.13.01.13.0.9加入了Minecoin金的格式化代码：§g。
1.17.401.17.40.21现在对着带有格式化代码的告示牌彩色文本使用染料染色会覆盖掉之前的格式化代码。
1.19.801.19.80.20加入了石英色、铁锭色、下界合金色、红石色、铜锭色、金锭色、绿宝石色、钻石色、青金石色、紫水晶色的格式化代码：§h、§j、§m、§n、§p、§q、§s、§t、§u。
1.21.501.21.50.25加入了树脂色的格式化代码：§v。
26.3026.30.27加入了格式化代码§w，用于多人游戏中的组队聊天。

Java版Alpha v1.0.12前的格式化代码表

代码 前景色 背景色
R G B Hex R G B Hex
§0 0 0 0
 #000000 		0 0 0
 #000000
§1 0 0 191
 #0000BF 		0 0 47
 #00002F
§2 0 191 0
 #00BF00 		0 47 0
 #002F00
§3 0 191 191
 #00BFBF 		0 47 47
 #002F2F
§4 191 0 0
 #BF0000 		47 0 0
 #2F0000
§5 191 0 191
 #BF00BF 		47 0 47
 #2F002F
§6 191 191 0
 #BFBF00 		47 47 0
 #2F2F00
§7 191 191 191
 #BFBFBF 		47 47 47
 #2F2F2F
§8 64 64 64
 #404040 		16 16 16
 #101010
§9 64 64 255
 #4040FF 		16 16 63
 #10103F
§a 64 255 64
 #40FF40 		16 63 16
 #103F10
§b 64 255 255
 #40FFFF 		16 63 63
 #103F3F
§c 255 64 64
 #FF4040 		63 16 16
 #3F1010
§d 255 64 255
 #FF40FF 		63 16 63
 #3F103F
§e 255 255 64
 #FFFF40 		63 63 16
 #3F3F10
§f 255 255 255
 #FFFFFF 		63 63 62
 #3F3F3F

你知道吗

  • 颜色代码在游戏中几乎完全匹配1981年发布的彩色图形适配器（CGA）的16种颜色，只有颜色6不同 –
    #FFAA00 – 不同于CGA –
    #AA5500。
  • Minecoin金（§g）在PlayStation上无法正常显示，会显示为无格式或透明。
  • 在基岩版中，如果使用除Mojangles之外的任何字体，随机字符（§k）会显示为点。

参考

  1. ↑ 1.0 1.1 MCPE-41729
  2. ↑ IRC logs on Archive.org; #minecraft.20090619.log. "P7:43:58 <Notch> Quatroking: want to know a secret?" [...] "P7:44:44 <Notch> /say He&1llo&f, world! &bHOW ARE YOU!?" [...] "P7:45:52 <Notch> it's the ega palette, almost" (June 20, 2009, 00:43:58 UTC)
  3. ↑ MC-296316
  4. ↑ MC-122 — 漏洞状态为“已修复”。
  5. ↑ MC-132664 — 漏洞状态为“已修复”。
  6. ↑ MC-133260 — 漏洞状态为“已修复”。
  7. ↑ MC-137571 — 漏洞状态为“已修复”。

导航

Java版可自定义内容
基本概念
数据包
注册
游戏行为
定义格式
生物变种
世界生成
标签
资源包
相关条目
官方工具
相关教程
参考实例
官方实例
教程实例
Java Edition icon 2.png Java版
版本
开发周期
版本记录
技术
开发资源
过时开发资源
多人游戏
游戏订制
取自“https://wiki.biligame.com/mc/index.php?title=格式化代码&oldid=522586”