JetBrains Rider 2025.2 Help

代码检查:元素可本地化

此检查会检测硬编码的字符串字面量,并建议 将它们移动到资源文件。 如果相同的字符串已在资源中定义,JetBrains Rider 将建议用现有的资源条目替换该文本。

由于并非每个字符串都需要移动到资源并进行本地化,JetBrains Rider 提供了多种方法来配置此检查。 当'元素可本地化'检查 启用时,它将按照下方的流程图工作。 算法中的每一步都在图表下方进行了说明。

JetBrains Rider:如何使用“元素可本地化”检查
  1. 可本地化 项目属性定义了如何处理项目中的字符串。 要更改此属性,请右键单击解决方案资源管理器中的项目,选择 属性 | 检查 ,然后选择 可本地化 > [默认 | 是 | 否]

  2. 如果当前项目或其引用的任何其他项目中至少包含一个资源文件( .resx ),JetBrains Rider 将默认将该项目视为可本地化。

  3. 可以通过将特定函数和属性标记为 可本地化属性 来进一步配置,这使您可以明确 [可本地化(true)] 启用或 [可本地化(false)] 禁用对所使用字符串的本地化检查。

    请注意,可以通过 外部注解 将符号标记为具有此属性。 例如,外部注解用于将 Console.WriteLine 标记为 [可本地化(true)]

  4. 可本地化检查器 项目属性 定义如何处理未被任何标记为 可本地化属性 的成员使用的字符串文本 — 乐观 算法将忽略此类字符串, 悲观将其标记为可本地化

    要更改此项目属性,请右键单击解决方案资源管理器中的项目,选择 属性 | 检查 ,然后选择 可本地化检查器 > [乐观 | 悲观]

禁用当前项目的本地化检查的最简单方法是,在编辑器中按 Alt+Enter 突出显示的字符串,并在 操作列表中使用相应的命令:

JetBrains Rider:为项目禁用本地化检查

此命令将当前项目中的 可本地化 属性设置为

最后修改日期: 2025年 9月 26日