refactor(options): 代码质量改进

OptionsDebugger:
- 提取魔法数字为常量 MaxDisplayElements 和 DefaultConsoleWidth
- 添加 private 访问修饰符
- 修复数组类型显示的尾随空格

OptionsProvider:
- 重命名变量 cachedOptions2 为 finalOptions
- 使用 ArgumentNullException.ThrowIfNull 替代显式抛出

OptionAttribute:
- 添加 DebuggerDisplay 特性提升调试体验

Author: AlianBlank

GameFrameX.Foundation.Options/Attributes/OptionAttribute.cs

@@ -37,6 +37,7 @@ namespace GameFrameX.Foundation.Options.Attributes;
 /// 表示一个命令行选项的特性
 /// </summary>
 [AttributeUsage(AttributeTargets.Property)]
+[System.Diagnostics.DebuggerDisplay("LongName = {LongName}, Required = {Required}, DefaultValue = {DefaultValue}")]
 public class OptionAttribute : Attribute
 {
     /// <summary>

GameFrameX.Foundation.Options/OptionsDebugger.cs

@@ -41,16 +41,18 @@ namespace GameFrameX.Foundation.Options
     /// </summary>
     public static class OptionsDebugger
     {
-        const string OptionHeader = "选项 (Option)";
-        const string ValueHeader = "值 (Value)";
-        const string RequiredHeader = "必需 (Required)";
-        const string TypeNameHeader = "类型 (Type)";
-        const string DescriptionHeader = "描述 (Description)";
-        const string DefaultValueHeader = "默认值 (Default)";
-        const string RequiredYesLabel = "是 (Yes)";
-        const string RequiredNoLabel = "否 (No)";
-        const string NoDescriptionLabel = "无描述 (No Description)";
-        const string NoOptionAttributeLabel = "无选项特性 (No Option Attribute)";
+        private const string OptionHeader = "选项 (Option)";
+        private const string ValueHeader = "值 (Value)";
+        private const string RequiredHeader = "必需 (Required)";
+        private const string TypeNameHeader = "类型 (Type)";
+        private const string DescriptionHeader = "描述 (Description)";
+        private const string DefaultValueHeader = "默认值 (Default)";
+        private const string RequiredYesLabel = "是 (Yes)";
+        private const string RequiredNoLabel = "否 (No)";
+        private const string NoDescriptionLabel = "无描述 (No Description)";
+        private const string NoOptionAttributeLabel = "无选项特性 (No Option Attribute)";
+        private const int MaxDisplayElements = 5;
+        private const int DefaultConsoleWidth = 120;
 
         /// <summary>
         /// 打印解析完成后的选项对象
@@ -174,7 +176,7 @@ public static void PrintParsedOptions<T>(T options) where T : class
                 }
                 catch
                 {
-                    consoleWidth = 120;
+                    consoleWidth = DefaultConsoleWidth;
                 }
 
                 int maxTableWidth = Math.Max(60, consoleWidth - 1);
@@ -452,13 +454,13 @@ private static string FormatPropertyValue(object value)
             {
                 var array = (Array)value;
                 var elements = new List<string>();
-                for (int i = 0; i < Math.Min(array.Length, 5); i++)
+                for (int i = 0; i < Math.Min(array.Length, MaxDisplayElements); i++)
                 {
                     elements.Add(array.GetValue(i)?.ToString() ?? "null");
                 }
 
                 var result = $"[{string.Join(", ", elements)}]";
-                if (array.Length > 5)
+                if (array.Length > MaxDisplayElements)
                 {
                     result += $" (Total {array.Length} elements / 共{array.Length}个元素)";
                 }
@@ -470,13 +472,13 @@ private static string FormatPropertyValue(object value)
             {
                 var list = (System.Collections.IList)value;
                 var elements = new List<string>();
-                for (int i = 0; i < Math.Min(list.Count, 5); i++)
+                for (int i = 0; i < Math.Min(list.Count, MaxDisplayElements); i++)
                 {
                     elements.Add(list[i]?.ToString() ?? "null");
                 }
 
                 var result = $"[{string.Join(", ", elements)}]";
-                if (list.Count > 5)
+                if (list.Count > MaxDisplayElements)
                 {
                     result += $" (Total {list.Count} elements / 共{list.Count}个元素)";
                 }
@@ -539,7 +541,7 @@ private static string GetFriendlyTypeName(Type type)
 
             if (type.IsArray)
             {
-                return $"Array of {GetFriendlyTypeName(type.GetElementType())} ";
+                return $"Array of {GetFriendlyTypeName(type.GetElementType())}";
             }
 
             if (type.IsGenericType && type.GetGenericTypeDefinition() == typeof(List<>))

GameFrameX.Foundation.Options/OptionsProvider.cs

@@ -152,10 +152,10 @@ private static bool ShouldEnableDebugOutput(bool? enableDebugOutput = null)
         var options = builder.Build(skipValidation);
 
         // 缓存选项（使用 GetOrAdd 确保线程安全）
-        var cachedOptions2 = OptionsCache.GetOrAdd(type, options);
+        var finalOptions = OptionsCache.GetOrAdd(type, options);
 
         // 如果是刚添加的，使用新构建的 options；如果是其他线程已添加的，使用缓存的
-        var result = ReferenceEquals(cachedOptions2, options) ? options : (T)cachedOptions2;
+        var result = ReferenceEquals(finalOptions, options) ? options : (T)finalOptions;
 
         // 如果启用调试输出，打印解析后的选项对象
         if (shouldDebug)
@@ -221,8 +221,10 @@ public static void RemoveFromCache<T>() where T : class
     /// </summary>
     /// <typeparam name="T">选项类型</typeparam>
     /// <param name="options">选项对象</param>
+    /// <exception cref="ArgumentNullException">当 options 为 null 时抛出</exception>
     public static void PrintOptionsInfo<T>(T options) where T : class
     {
+        ArgumentNullException.ThrowIfNull(options);
         OptionsDebugger.PrintParsedOptions(options);
     }