如何限制C#函数仅接受字符串字面量以适配gettext翻译提取？

这问题我在做本地化项目时也踩过坑，动态拼接的字符串确实会让gettext提取引擎抓不到，分享几个实用的解决思路：

1. 自定义Roslyn分析器（最推荐，编译期强制） #

这是最靠谱的方案，能在编译阶段直接拦截非字面量的调用，还能集成到VS里实时提示开发者。

你可以写一个Roslyn分析器，核心逻辑是：

• 识别所有调用GetText._的方法节点
• 检查传入的参数是否是字符串字面量表达式（LiteralExpressionSyntax）
• 如果是动态拼接（比如"a" + x这类BinaryExpressionSyntax），就抛出编译警告或错误

举个简单的分析器核心代码片段：

public override void Initialize(AnalysisContext context)
{
    context.RegisterSyntaxNodeAction(AnalyzeInvocation, SyntaxKind.InvocationExpression);
}

private void AnalyzeInvocation(SyntaxNodeAnalysisContext context)
{
    var invocation = (InvocationExpressionSyntax)context.Node;
    var methodSymbol = context.SemanticModel.GetSymbolInfo(invocation.Expression).Symbol as IMethodSymbol;
    
    // 检查是不是GetText._方法
    if (methodSymbol?.ContainingType.Name == "GetText" && methodSymbol.Name == "_")
    {
        var argument = invocation.ArgumentList.Arguments.FirstOrDefault();
        if (argument?.Expression is not LiteralExpressionSyntax)
        {
            context.ReportDiagnostic(Diagnostic.Create(
                Rule, 
                argument.GetLocation(), 
                "GetText._仅允许传入字符串字面量"));
        }
    }
}

这个方案的优势是从根源上杜绝非字面量调用，开发者写代码时就能得到反馈，不会等到提取翻译时才发现问题。

2. 利用C# 10+的[StringSyntax]特性（IDE提示，非强制） #

如果不想写自定义分析器，可以用C# 10引入的StringSyntax特性标记GetText._的参数，告诉IDE这个参数应该是字符串字面量：

using System.Diagnostics.CodeAnalysis;

public static class GetText
{
    public static string _([StringSyntax("Literal")] string key)
    {
        // 翻译逻辑
    }
}

这样在VS里传入动态拼接的字符串时，IDE会给出警告，但不会阻止编译。适合配合代码审查一起用，作为轻量级的约束手段。

3. 自定义包装类型（半编译期约束） #

你可以创建一个只接受字符串字面量的包装结构体，通过私有构造+隐式转换来引导规范：

public readonly struct LocalizationKey
{
    public string Value { get; }

    // 私有构造，外部无法直接实例化
    private LocalizationKey(string value) => Value = value;

    // 标记仅接受字面量，IDE会给出提示
    [StringSyntax("Literal")]
    public static implicit operator LocalizationKey(string literal) => new LocalizationKey(literal);
}

public static class GetText
{
    public static string _(LocalizationKey key)
    {
        return Translate(key.Value);
    }
}

这种方式下，GetText._("hello")是合法的，但GetText._("a" + x)虽然能编译，IDE会因为StringSyntax特性给出警告，同时也能引导开发者尽量使用字面量。

4. 回归预处理方案（备选） #

如果上面的方案都觉得复杂，预处理也是可行的选择：

• 用T4模板或者自定义脚本扫描代码文件，找出所有GetText._的调用
• 检查参数是否为字面量，若发现动态拼接则抛出错误
• 可以把这个步骤集成到CI/CD流程里，确保只有符合要求的代码才能通过构建

不过预处理的缺点是反馈不够及时，开发者要等到构建时才会发现问题，体验不如编译期检查。

内容的提问来源于stack exchange，提问作者xtofl