由 AI 生成属性默认值的部分

Author: walterlv

docs/en/README.md

@@ -193,6 +193,60 @@ class Options
 
 If a required option is not provided, a `RequiredPropertyNotAssignedException` will be thrown during parsing.
 
+## Property Initial Values and Accessors
+
+When defining option types, it's important to understand the relationship between property initial values and accessor modifiers (`init`, `required`):
+
+```csharp
+class Options
+{
+    // Incorrect example: when using init or required, default values will be ignored
+    [Option('f', "format")]
+    public string Format { get; init; } = "json";  // Default value won't work!
+    
+    // Correct example: use set to retain the default value
+    [Option('f', "format")]
+    public string Format { get; set; } = "json";  // Default value will be preserved
+}
+```
+
+### Important Notes About Property Initial Values
+
+1. **Behavior with `init` or `required`**:
+   - When a property includes `required` or `init` modifiers, the initial value will be ignored
+   - If the option is not provided in command line arguments, the property will be set to `default(T)` (null for reference types)
+   - This is determined by C# language design, not a limitation of the command line library
+
+2. **How to preserve default values**:
+   - If you need to provide a default value for a property, use `{ get; set; }` instead of `{ get; init; }`
+
+3. **Nullable types and warning handling**:
+   - For non-required reference type properties, mark them as nullable (e.g., `string?`) to avoid nullable warnings
+   - For value types (e.g., `int`, `bool`), if you want to keep the default value rather than null, don't mark them as nullable
+
+Example:
+
+```csharp
+class OptionsBestPractice
+{
+    // Required option: using required, no need to worry about default values
+    [Option("input")]
+    public required string InputFile { get; init; }
+    
+    // Optional option: mark as nullable type to avoid warnings
+    [Option("output")]
+    public string? OutputFile { get; init; }
+    
+    // Option needing default value: use set instead of init
+    [Option("format")]
+    public string Format { get; set; } = "json";
+    
+    // Value type option: no need to mark as nullable
+    [Option("count")]
+    public int Count { get; set; } = 1;
+}
+```
+
 ## Command Handling and Verbs
 
 You can use the command handler pattern to handle different commands (verbs), similar to `git commit`, `git push`, etc. DotNetCampus.CommandLine provides several ways to add command handlers:
@@ -241,7 +295,7 @@ internal class ConvertCommandHandler : ICommandHandler
     public string? OutputFile { get; init; }
 
     [Option('f', "format")]
-    public string Format { get; init; } = "json";
+    public string Format { get; set; } = "json";
 
     public Task<int> RunAsync()
     {

docs/zh-hans/README.md

@@ -193,6 +193,60 @@ class Options
 
 如果未提供必需选项，解析时会抛出`RequiredPropertyNotAssignedException`异常。
 
+## 属性初始值与访问器修饰符
+
+在定义选项类型时，需要注意属性初始值与访问器修饰符（`init`、`required`）之间的关系：
+
+```csharp
+class Options
+{
+    // 错误示例：当使用 init 或 required 时，默认值将被忽略
+    [Option('f', "format")]
+    public string Format { get; init; } = "json";  // 默认值不会生效！
+    
+    // 正确示例：使用 set 以保留默认值
+    [Option('f', "format")]
+    public string Format { get; set; } = "json";  // 默认值会正确保留
+}
+```
+
+### 关于属性初始值的重要说明
+
+1. **使用 `init` 或 `required` 时的行为**：
+   - 当属性包含 `required` 或 `init` 修饰符时，属性的初始值会被忽略
+   - 如果命令行参数中未提供该选项的值，属性将被设置为 `default(T)`（对于引用类型为 `null`）
+   - 这是由 C# 语言特性决定的，命令行库如果希望突破此限制需要针对所有属性排列组合进行处理，显然是非常浪费的
+
+2. **保留默认值的方式**：
+   - 如果需要为属性提供默认值，应使用 `{ get; set; }` 而非 `{ get; init; }`
+
+3. **可空类型与警告处理**：
+   - 对于非必需的引用类型属性，应将其标记为可空（如 `string?`）以避免可空警告
+   - 对于值类型（如 `int`、`bool`），如果想保留默认值而非 `null`，不应将其标记为可空
+
+示例：
+
+```csharp
+class OptionsBestPractice
+{
+    // 必需选项：使用 required，无需担心默认值
+    [Option("input")]
+    public required string InputFile { get; init; }
+    
+    // 可选选项：标记为可空类型以避免警告
+    [Option("output")]
+    public string? OutputFile { get; init; }
+    
+    // 需要默认值的选项：使用 set 而非 init
+    [Option("format")]
+    public string Format { get; set; } = "json";
+    
+    // 值类型选项：不需要标记为可空
+    [Option("count")]
+    public int Count { get; set; } = 1;
+}
+```
+
 ## 命令处理与谓词
 
 你可以使用命令处理器模式处理不同的命令（谓词），类似于`git commit`、`git push`等。DotNetCampus.CommandLine 提供了多种添加命令处理器的方式：
@@ -241,7 +295,7 @@ internal class ConvertCommandHandler : ICommandHandler
     public string? OutputFile { get; init; }
 
     [Option('f', "format")]
-    public string Format { get; init; } = "json";
+    public string Format { get; set; } = "json";
 
     public Task<int> RunAsync()
     {

docs/zh-hant/README.md

@@ -193,6 +193,60 @@ class Options
 
 如果未提供必需選項，解析時會拋出`RequiredPropertyNotAssignedException`異常。
 
+## 屬性初始值與訪問器修飾符
+
+在定義選項類型時，需要注意屬性初始值與訪問器修飾符（`init`、`required`）之間的關係：
+
+```csharp
+class Options
+{
+    // 錯誤示例：當使用 init 或 required 時，默認值將被忽略
+    [Option('f', "format")]
+    public string Format { get; init; } = "json";  // 默認值不會生效！
+    
+    // 正確示例：使用 set 以保留默認值
+    [Option('f', "format")]
+    public string Format { get; set; } = "json";  // 默認值會正確保留
+}
+```
+
+### 關於屬性初始值的重要說明
+
+1. **使用 `init` 或 `required` 時的行為**：
+   - 當屬性包含 `required` 或 `init` 修飾符時，屬性的初始值會被忽略
+   - 如果命令行參數中未提供該選項的值，屬性將被設置為 `default(T)`（對於引用類型為 `null`）
+   - 這是由 C# 語言特性決定的，命令行庫如果希望突破此限制需要針對所有屬性排列組合進行處理，顯然是非常浪費的
+
+2. **保留默認值的方式**：
+   - 如果需要為屬性提供默認值，應使用 `{ get; set; }` 而非 `{ get; init; }`
+
+3. **可空類型與警告處理**：
+   - 對於非必需的引用類型屬性，應將其標記為可空（如 `string?`）以避免可空警告
+   - 對於值類型（如 `int`、`bool`），如果想保留默認值而非 `null`，不應將其標記為可空
+
+示例：
+
+```csharp
+class OptionsBestPractice
+{
+    // 必需選項：使用 required，無需擔心默認值
+    [Option("input")]
+    public required string InputFile { get; init; }
+    
+    // 可選選項：標記為可空類型以避免警告
+    [Option("output")]
+    public string? OutputFile { get; init; }
+    
+    // 需要默認值的選項：使用 set 而非 init
+    [Option("format")]
+    public string Format { get; set; } = "json";
+    
+    // 值類型選項：不需要標記為可空
+    [Option("count")]
+    public int Count { get; set; } = 1;
+}
+```
+
 ## 命令處理與謂詞
 
 你可以使用命令處理器模式處理不同的命令（謂詞），類似於`git commit`、`git push`等。DotNetCampus.CommandLine 提供了多種添加命令處理器的方式：
@@ -241,7 +295,7 @@ internal class ConvertCommandHandler : ICommandHandler
     public string? OutputFile { get; init; }
 
     [Option('f', "format")]
-    public string Format { get; init; } = "json";
+    public string Format { get; set; } = "json";
 
     public Task<int> RunAsync()
     {