使用 System.CommandLine 的应用在某些 shell 中内置了对 Tab 自动补全的支持。 若要启用它，每次启动新的 shell 时，最终用户必须执行几个步骤。 完成此操作后，应用中的静态值（例如枚举值或通过调用 AcceptOnlyFromAmong(String[]) 定义的值）将使用 Tab 键自动补全。 你还可以通过在运行时动态提供值来定制 Tab 键补全功能。
启用Tab键补全
在（最终用户）想要启用选项卡完成的计算机上，请按照以下步骤作。
对于 .NET CLI：
- 请参阅如何启用 Tab 自动补全。
对于其他基于System.CommandLine构建的命令行应用：
安装
dotnet-suggest全局工具：dotnet tool install -g dotnet-suggest将适当的填充码脚本添加到 shell 配置文件中。 可能需要创建 shell 配置文件。 桥接脚本会将 shell 中的完成请求转发到
dotnet-suggest工具，该工具会将这些请求委托给相应的基于System.CommandLine的应用程序。对于
bash，将 dotnet-suggest-shim.bash 的内容添加到 ~/.bash_profile。对于
zsh，将 dotnet-suggest-shim.zsh 的内容添加到 ~/.zshrc。对于 PowerShell，请将 dotnet-suggest-shim.ps1 的内容添加到 PowerShell 配置文件，然后重启 PowerShell。 可以使用以下命令找到 PowerShell 配置文件的预期路径：
echo $profile
通过调用
dotnet-suggest register --command-path $executableFilePath注册应用，其中$executableFilePath是应用的可执行文件的路径。
设置用户的 shell 并注册可执行文件后，补全功能将适用于使用 System.CommandLine 构建的所有应用。
对于 Windows 上的 cmd.exe （Windows 命令提示符），没有可插入的选项卡完成机制，因此没有可用的填充码脚本。 对于其他 shell，请查找带有标签Area-Completions的 GitHub 问题。 如果找不到问题，可以 打开一个新问题。
在运行时获取选项卡完成值
以下代码显示了一个应用，该应用在运行时动态检索要通过 Tab 键补全的值。 该代码获取当前日期后的下一周日期的列表。 提供给--date选项的列表是通过调用CompletionSources.Add获得的。
using System.CommandLine;
using System.CommandLine.Completions;
using System.CommandLine.Parsing;
new DateCommand().Parse(args).Invoke();
class DateCommand : Command
{
private Argument<string> subjectArgument = new("subject")
{
Description = "The subject of the appointment."
};
private Option<DateTime> dateOption = new("--date")
{
Description = "The day of week to schedule. Should be within one week."
};
public DateCommand() : base("schedule", "Makes an appointment for sometime in the next week.")
{
this.Arguments.Add(subjectArgument);
this.Options.Add(dateOption);
dateOption.CompletionSources.Add(ctx => {
var today = System.DateTime.Today;
List<CompletionItem> dates = new();
foreach (var i in Enumerable.Range(1, 7))
{
var date = today.AddDays(i);
dates.Add(new CompletionItem(
label: date.ToShortDateString(),
sortText: $"{i:2}"));
}
return dates;
});
this.SetAction(parseResult =>
{
Console.WriteLine($"Scheduled \"{parseResult.GetValue(subjectArgument)}\" for {parseResult.GetValue(dateOption)}");
});
}
}
按下 Tab 键时显示的值是作为 CompletionItem 实例提供的：
dates.Add(new CompletionItem(
label: date.ToShortDateString(),
sortText: $"{i:2}"));
设置了以下 CompletionItem 属性：
- Label 是要显示的补全值。
-
SortText 确保列表中的值按正确的顺序显示。 通过将
i转换为两个数字的字符串，以便按 01、02、03 一直到 14 进行排序。 如果未设置此参数，则排序基于Label该参数，在此示例中采用短日期格式，并且无法正确排序。
CompletionItem还有其他属性，如Documentation和Detail，但它们尚未用于System.CommandLine。
此代码创建的动态选项卡完成列表也显示在帮助输出中：
Description:
Makes an appointment for sometime in the next week.
Usage:
schedule <subject> [options]
Arguments:
<subject> The subject of the appointment.
Options:
--date The day of week to schedule. Should be within one week.
<12/4/2025|12/5/2025|12/6/2025|12/7/2025|12/8/2025|12/9/2025|12/10/2025>
--version Show version information
-?, -h, --help
