Solana 代币元数据更新：名称、符号和图标

代币元数据更新看着是一件事，其实是两件。元数据就是代币对外的那张名片：名称、符号、图标、描述和链接。可这些信息不在一个地方，而在两个地方，各改各的。

上线之后最常收到的消息也是从这里来的：图标一周前就换了，Solscan 上还挂着旧名称。

• 名称、符号和网址写在链上，改动要付手续费。
• 图标、描述和社交链接放在一个文件里，改动不花钱。
• 改其中一层，另一层永远不会跟着动。
• 锁定是唯一一个撤不回来的决定。

元数据的两层结构

代币刚创建时，它的信息通过 Metaplex Token Metadata 写入，这是 Solana 上几乎每个代币都遵循的标准，第一层就是这样来的。这个账户怎么挂到铸造地址上，写在 Solana 官方的 Metaplex Metadata 文档里。

第一层在链上。它只装三样东西：名称、符号（代号）、以及一个指向某个文件的网址。钱包和浏览器先读这一层。碰这三样中的任何一样，都是往链上写，都要花钱。

第二层是那个网址指向的文件。里面放着图标、描述、官网和社交链接。换掉其中任何一样，无非是把同一个文件重新上传到同一个网址。没有交易，也没有手续费。

所以有人换了图标而名称没动，并不是坏了。图标在文件里，名称在链上，改一边永远不会牵动另一边。

字段	层	怎么改	花费
代币名称	链上	更新工具	0.2 SOL
符号（代号）	链上	更新工具	0.2 SOL
网址（URI）	链上	更新工具	0.2 SOL
图标	文件	重新上传到同一网址	免费
描述	文件	重新上传到同一网址	免费
官网和社交	文件	重新上传到同一网址	免费

什么时候才真的需要动元数据

• 想换新图标。设计交了更好的版本。图标在文件里，重新上传到同一个网址就完事了，免费。
• 某个链接变了。Discord 搬了服务器，X 账号换了，官网换了域名。还是那句话：改文件。
• 名称或符号写错了。用临时名字上线了，或者代号里有个错别字。这一面是封住的，得走更新工具。
• 要把文件挪到永久存储。网址本身变了，所以这也算往链上写。这一步永远排在锁定之前。

前两种情况根本不碰链，也不花钱，想改几次就改几次。后两种走的是同一个表单，无论改的是名称、代号还是网址。说白了：外观相关的都免费，只有那三个封住的字段有价格。

Solana 上代币元数据更新的完整步骤

只换图标或链接的话，下面这些一步都用不上。要改名称、符号或网址，路线是四步。

• 先看现状。打开代币状态查询工具，把代币地址贴进去。它读出当前的值，并告诉你修改权限是否还握在某个钱包手里。免费，而且如果权限已经交出去了，付费也没有意义。
• 连对钱包。只有持有该权限的钱包能签名。换别的钱包，改动根本进不去。
• 填新值并签名。在元数据更新工具里粘贴地址，写好要改的内容，然后在钱包里确认。当时的费用会在确认之前显示在页面上。
• 改完再核对。把状态查询再跑一遍。图标要有点耐心，钱包会把图片缓存十到三十分钟。

锁定之前，文件必须放在永久的地方。反复上演的事故是这样：团队上线时把文件丢到一个免费主机上，几周后锁了元数据，几个月后那个主机到期。网址开始返回 404。名称还在，因为它封在链上，可图标和描述都没了，而修改权限已经交出去，谁也没法把代币指向新文件。

锁还是不锁

迟早有人会劝你锁定元数据。锁定的意思是永久交出修改权限，让任何人都改不了，包括团队自己。买的人乐意看到这个，有些上所的检查清单也会问。

真正决定成败的是顺序。先把文件挪到 Arweave 或者做了 pin 的 IPFS，再把链上网址指向新链接，然后用两台不同的机器连着几天确认能打开，到这一步才锁。

锁的时候可以选深浅。撤销修改权限的工具只拿走名称、符号和网址这三样的权利。一键不可变工具把修改、铸造和冻结三项权限一次性交出去。三者的并排对比在放弃代币权限的那篇里。

实用的判断标准是这样：品牌定下来了、代币跑了半年没有改名打算、文件已经在永久存储上，或者交易所明确要求，那就锁。还可能改品牌、主机可能丢、二代版本还在讨论，那就等。整个流程里只有这一扇门是单向的。

为什么有时候改不进去

两个原因几乎覆盖所有情况。要么修改权限早就被撤销了，很多是在创建时顺手撤的，那么名称、符号和网址就永远封住了。要么连上的钱包不是持有权限的那个。

第二种看着像工具坏了，其实不是。状态查询会告诉你权限在哪个钱包上，把那一个连上就行。如果权限确实没了，就没有退路，唯一的办法是重新铸造一个代币。

还有第三种，看着像前两种，其实无害：改动早就生效了，钱包还在显示旧图片。代币显示不对或者根本不显示的各种原因都收在代币在 Phantom 里不显示那篇里。至于让代币出现在浏览器的搜索里，那是另一套有自己条件的流程，写在 Solana 的代币验证指南里。

最常重复的错误

• 改了文件就以为名称也跟着改了。图标在文件里，名称在链上，两边要分开核对。
• 文件还在临时主机上就锁定。这份清单里最贵的错误，事后没有任何补救。
• 不等缓存。十到三十分钟很正常。重新操作之前，先读一遍状态查询。
• 想通过文件改名称。文件里的名称字段钱包压根不读。真正的改名一律走更新工具。
• 用错钱包签名。不花手续费，但每次都要多花几分钟犯迷糊。

还有一个比其他几条更容易漏掉的细节：你是在什么状态下看那个文件的。不少团队直接在浏览器里打开网址，看到的是浏览器自己缓存的旧版本，于是断定上传失败了。换成无痕窗口打开，或者在网址后面加个随便什么参数，看到的就和一个全新钱包看到的一样了。

代币元数据常见问题

上线之后还能改代币名称吗

只要修改权限还在某个钱包手里就能改。状态查询免费告诉你结果，然后改一次 0.2 SOL，由那个钱包签名。

为什么我的代币还显示旧图标

要么改错了层，要么钱包还缓存着旧图。把图标重新上传到同一网址，读一遍状态，再等缓存过去。

更新一次要多少钱

改文件不花钱。改名称、符号或网址是 0.2 SOL，外加一点网络费，金额在确认之前显示在页面上。

要不要把代币做成不可变

品牌稳了、代币有了些历史、文件也在永久存储上，那就做。还有改品牌的可能，就先等着。

修改权限是什么

是某个特定钱包持有的、日后还能编辑链上元数据的那份权利。一旦交出去，这条记录就永远封住了。

Token-2022 也一样吗

只有一部分一样。Token-2022 可以把元数据带在代币自己身上，走的是另一条路。这篇讲的是多数人在用的 SPL 加 Metaplex 流程。

动手之前

更新便宜又能重来，所以第一天不必样样完美。名称能改，图标能换，链接想挪几次就挪几次。唯一不可逆的是锁定：先把文件搬到永久存储，把网址指过去，确认能打开，然后才交出权限。