如何在MetAmask中手动添加令牌图标？

MetAmask用户可以通过更新自定义令牌列表或使用开发人员工具来提高对不支持的ERC-20代币的识别来手动添加令牌图标。

2025/06/12 03:49

什么是metamask，为什么需要添加令牌图标？

MetAmask是一个流行的加密货币钱包，允许用户与以太坊区块链进行交互。它不仅支持以太（ETH），还支持各种ERC-20令牌。尽管许多常用的令牌会自动在MetAmask接口中显示其图标，但一些鲜为人知或新启动的令牌可能不会显示图标，因此很难一目了然地识别它们。

通过确保每个令牌具有可识别的视觉表示形式，可以手动添加令牌图标有助于提高可用性。这对于定期管理多个代币的用户特别有用。如果您在没有图标的情况下遇到令牌，则可能是因为MetAmask尚未索引令牌的元数据，或者令牌开发人员尚未将其提交给公共存储库中。

MetAmask如何显示令牌图标？

Metamask从多个来源中提取令牌信息，包括Coingecko和社区维护的令牌列表，例如在GitHub存储库中找到的tokenlists.org上的列表。当将令牌添加到用户的钱包中时， MetAmask尝试从这些来源获取其符号，名称和图标。如果没有数据，则代币将带有通用占位符图标。

图标本身通常被存储为指向在线托管的图像文件的URL。为了使MetAmask显示正确的图标，令牌合同地址必须与该图像URL相关联，其中一个已公认的令牌列表之一。手动添加令牌图标涉及更新以下列表之一或配置本地钱包以识别自定义图标路径。

通过自定义令牌列表手动添加令牌图标的步骤

要在MetAmask中手动添加令牌图标，一种方法涉及创建或修改包含所需令牌图标URL的自定义令牌列表JSON文件。以下是：

• 确保您有代币的合同地址和图标URL 。

• 创建一个新的JSON文件或按照格式修改现有文件：

   {
   'name': 'Custom Token List',
   'logoURI': 'https://example.com/icon.png',
   'timestamp': '2024-03-15T12:00:00Z',
   'tokens': [ { 'chainId': 1, 'address': '0x...', 'symbol': 'TKN', 'name': 'Token Name', 'decimals': 18, 'logoURI': 'https://example.com/tkn-icon.png' }

  这是给出的
  }

• 保存文件并将其上传到公开访问的服务器或托管服务（例如，GitHub页面）。

• 在MetAmask中，转到设置>高级>管理令牌列表。

• 单击“添加令牌”列表，然后粘贴托管JSON文件的URL。

• 如有必要，请确认并重新加载元张纸。

完成这些步骤后，您的自定义令牌图标现在应与钱包中的令牌名称一起出现。

添加一个令牌图标而不修改令牌列表

如果您不想处理外部令牌列表，则可以使用开发人员工具手动覆盖MetAmask实例中的令牌图标。此方法仅适用于您的本地安装，不会影响其他用户。

• 打开MetAmask并确保已添加您要自定义的令牌。
• 右键单击浏览器中的MetAmask扩展程序，然后选择“ Inspect”以打开开发人员工具。
• 导航到“应用程序”选项卡，然后在本地存储下找到metamask-controller-state的条目。
• 找到tokens部分并找到与合同地址相对应的令牌对象。
• 在令牌对象中，添加一个新的键值对： 'iconUrl': 'https://example.com/tkn-icon.png' 。
• 重新加载metAmask查看更新的图标。

这种方法需要熟悉浏览器开发人员工具，除非备份，否则在设备或会话中不会持续。

您在哪里可以找到手动添加的令牌图标？

当手动将其添加到MetAmask时，为特定令牌找到正确的图标至关重要。最可靠的来源包括：

• 官方代币网站：大多数项目在其官方网站上主持高质量的图标。
• GitHub存储库：许多令牌开发人员在公共存储库中维护包括图标在内的资产。
• 社区驱动的令牌列表： tokenlists.org之类的平台通常包含用于各种令牌的经过验证的图标URL。
• 第三方资产目录：某些服务汇总令牌元数据并提供可下载的图标。

在使用图标URL之前，请确保它直接指向.png文件，并且在没有身份验证的情况下可以公开访问。使用损坏或未经授权的链接可能会导致图标未能加载或被元掩模阻止。

---

常见问题（常见问题解答）

问：我可以在metAmask中使用任何图像格式吗？

MetAmask主要支持.png文件，因为它们的透明度支持和广泛的兼容性。使用.jpg或.svg之类的其他格式可能会导致显示问题或不支持的渲染。

问：更新MetAmask后，手动添加的令牌图标会留在吗？

通过本地修改添加的图标（例如编辑本地存储）可能会在更新或缓存清除后重置。但是，只要列表保持活跃且没有变化，就可以保留通过自定义令牌列表添加的图标。

问：MetAmask中的令牌图标是否需要大小要求？

虽然没有严格的尺寸要求，但建议使用至少64x64像素的正方形图像，以澄清一下。对于高分辨率显示，首选较大的尺寸（例如256x256）。

问：我可以提交令牌的图标以包含在metamask的默认列表中吗？

是的，您可以将令牌提交给Coingecko或Uniswap的令牌列表等平台，以获得更广泛的识别。服从这些服务会增加在无手动干预的情况下自动图标检测的可能性。