收到一笔转账，钱包里却看不到，这种情况在 MetaMask 上很常见。原因多半不是没到账，而是这个代币没被加进显示列表，或者收到的是同名但不同合约的代币，价格那一栏自然也是空的。这篇讲代币这一块：怎么把代币加进来显示、同名代币怎么分辨、为什么有的代币不显示价格。适合刚从交易所提币到 MetaMask、或者常收到各种新代币的人。只持有主流币、地址里干干净净的，基本不会碰到这些问题。
1. 代币显示管理：按合约把代币加进列表，也可以隐藏不再关注的。
2. 合约地址校验：添加时校验地址格式与链上是否匹配，避免填错。
3. 代币详情查看：点进单个代币看余额、合约与近期转账记录。
4. 余额自动识别：对已收录的常见代币自动带出名称与精度。
5. 隐藏余额汇总：被隐藏的代币不计入首页总额，避免干扰判断。
6. 跨链同名区分：同一代币在不同链上分别记录，按网络归到各自条目下。
1. 添加代币时会带出链上读到的名称和精度，不用手填小数位。
2. 同名代币按合约地址区分，列表里能同时存在两个同名条目而不混淆。
3. 隐藏操作即时生效，隐藏后首页总额同步变化。
4. 代币详情页直接给出合约地址，复制出来核对很方便。
1. 资源占用：代币信息按需读取，列表长也不会每次打开都全量拉取。
2. 兼容性：扩展端与手机端共用同一份代币配置，添加一次两边可见。
3. 上手门槛：常见代币可以搜名称添加，不用先找合约地址。
4. 安全设计：添加时展示合约来源，未收录的代币会提示手动确认。
5. 更新维护：代币收录信息随版本更新，已添加的条目不受影响。
先在区块浏览器上查地址，确认这笔转账的状态和接收链。MetaMask 的首页只显示已经加入列表的代币，链上到了但列表里没这个条目，就不会出现。确认到账之后，用转账记录里的合约地址手动添加，余额就出来了。这一步的关键是合约地址要从记录或官方渠道复制，不要在搜索框里凭名字选一个，同名代币在链上并不少见，选错了会加到另一个合约上，看起来余额是 0，实际是加错了目标。
看合约地址，不看名字。链上任何人都能发一个叫同样名字的代币，名称、符号、甚至图标都可以抄，唯一没法复制的是合约地址。MetaMask 在添加时会把读到的合约地址显示在确认页，把它和官方公布的地址逐位对一遍，位数不一样就是两个东西。对完地址再看小数位和总量，这些从链上读出来的数据也能辅助判断。分辨成本不高，但这一步省掉的话，后面所有基于余额的判断都建立在不确定之上。
价格来自外部数据源的收录，不是钱包自己算的。刚上线、流动性薄、或者只在某个小交易所交易的代币，数据源没覆盖到，MetaMask 里就只显示数量不显示价格。这不影响转账和使用，只影响首页的总额汇总。想让总额准确，可以手动核对这类代币的价值，或者干脆把它隐藏掉，汇总里就不掺这个数了。还有一种情况是代币所在的网络没被当前账户启用，切到对应网络就能正常读到。
v12.5.0（2026-09-26）
1. 添加代币新增合约地址来源提示。
2. 代币详情页可直接复制合约地址。
3. 首页总额计算新增手动排除隐藏代币。
