如何正确处理libphonenumber-csharp中PhoneNumberUtil类的实例？

问题背景 #

我正在使用Java库的C#移植版libphonenumber-csharp解析电话号码，但对PhoneNumberUtil类的实例处理方式存在困惑。以下是该类获取实例的核心源码：

public class PhoneNumberUtil
{
    // Summary:
    //     Gets a PhoneNumbers.PhoneNumberUtil instance to carry out international phone
    //     number formatting, parsing, or validation. The instance is loaded with phone
    //     number metadata for a number of most commonly used regions.
    //     The PhoneNumbers.PhoneNumberUtil is implemented as a singleton. Therefore, calling
    //     getInstance multiple times will only result in one instance being created.
    //
    // Returns:
    //     A PhoneNumbers.PhoneNumberUtil instance.
    public static PhoneNumberUtil GetInstance()
    {
        return instance ?? GetInstance("PhoneNumberMetaData.xml");
    }
    
    public static PhoneNumberUtil GetInstance(string baseFileLocation, Dictionary<int, List<string>> countryCallingCodeToRegionCodeMap = null)
    {
        lock (ThisLock)
        {
            return instance ?? (instance = new PhoneNumberUtil(baseFileLocation, null, countryCallingCodeToRegionCodeMap));
        }
    }
}

我习惯直接调用静态工具类的方法（比如PhoneNumberUtil.Parse(args...)），因此纠结两种实现方式：

方式一：静态字段保存复用实例 #

using PhoneNumbers;

internal static class PhoneNumberHelper
{
    private readonly static PhoneNumberUtil _phoneNumberUtil = PhoneNumberUtil.GetInstance();
    private const string SwedishCountryCode = "SE";

    public static bool TryParsePhoneNumber(string phonenumberToParse, out string result)
    {
        try
        {
            var phoneNumber = _phoneNumberUtil.Parse(phonenumberToParse, SwedishCountryCode);
            result = phoneNumber.CountryCode.ToString() + phoneNumber.NationalNumber;
            return true;
        }
        catch (Exception ex)
        {
            result = string.Empty;
            return false;
        }
    }
}

方式二：每次调用方法时获取实例 #

using PhoneNumbers;

internal static class PhoneNumberHelper
{
    private const string SwedishCountryCode = "SE";

    public static bool TryParsePhoneNumber(string phonenumberToParse, out string result)
    {
        try
        {
            var phoneNumber = PhoneNumberUtil.GetInstance().Parse(phonenumberToParse, SwedishCountryCode);
            result = phoneNumber.CountryCode.ToString() + phoneNumber.NationalNumber;
            return true;
        }
        catch (Exception ex)
        {
            result = string.Empty;
            return false;
        }
    }
}

请问这两种方式是否有区别？哪种更合理？我是否混淆了静态类与单例模式的概念？

解答 #

1. 两种方式的区别 #

从功能本质来看，两种方式最终都会复用同一个PhoneNumberUtil实例——因为PhoneNumberUtil本身是单例实现，GetInstance()无论调用多少次，只会在第一次调用时创建实例，后续调用直接返回已有的实例。

两者的唯一差异在于实例初始化的时机：

• 方式一：当PhoneNumberHelper类被CLR加载时，就会初始化静态字段_phoneNumberUtil，提前创建好PhoneNumberUtil实例。
• 方式二：只有当TryParsePhoneNumber方法第一次被调用时，才会触发PhoneNumberUtil实例的创建，属于懒加载。

2. 哪种方式更合理 #

两种方式在功能上没有本质差异，但从代码简洁性和贴合库设计的角度，方式二更优：

• 无需额外维护静态字段，代码更简洁，减少冗余。
• 依赖库本身的单例特性即可保证实例复用，不需要自己再封装一层静态引用，更贴合原库的设计逻辑。
• 懒加载特性可以避免程序启动时就加载未用到的实例（虽然PhoneNumberUtil初始化开销很小，但这是更合理的资源使用方式）。

3. 是否混淆了静态类与单例模式 #

确实存在一定的混淆，两者的核心区别如下：

• 静态类：无法实例化，所有成员都是静态的，调用时直接通过类名访问，本质上是无实例的全局访问。
• 单例模式：允许实例化，但整个应用生命周期中只会存在一个实例，通过静态方法获取实例后，调用实例的非静态方法（比如PhoneNumberUtil.Parse）。

你习惯的静态工具类是直接调用静态方法，但PhoneNumberUtil采用的是单例设计，必须先获取实例再调用实例方法。两者目的都是实现全局复用，但实现机制不同。

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