这是 AWS CDK v2 开发者指南。旧版 CDK v1 于 2022 年 6 月 1 日进入维护阶段，并于 2023 年 6 月 1 日终止支持。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `cdk list`
<a name="ref-cli-cmd-list"></a>

列出 CDK 应用程序中的所有 AWS CDK 堆栈及其依赖项。

## 使用量
<a name="ref-cli-cmd-list-usage"></a>

```
$ cdk list <arguments> <options>
```

## 参数
<a name="ref-cli-cmd-list-args"></a><a name="ref-cli-cmd-list-args-stack-name"></a>

 **CDK 堆栈 ID**   
应用程序中执行此命令的 CDK 堆栈的构造 ID。  
 *类型*：字符串  
 *必需*：否

## 选项
<a name="ref-cli-cmd-list-options"></a>

有关适用于所有 CDK CLI 命令的全局选项的列表，请参阅[全局选项](ref-cli-cmd.md#ref-cli-cmd-options)。<a name="ref-cli-cmd-list-options-help"></a>

 `--help, -h <BOOLEAN>`   
显示 `cdk list` 命令的命令参考信息。<a name="ref-cli-cmd-list-options-long"></a>

 `--long, -l <BOOLEAN>`   
显示每个堆栈的 AWS 环境信息。  
 *默认值*：`false`<a name="ref-cli-cmd-list-options-show-dependencies"></a>

 `--show-dependencies, -d <BOOLEAN>`   
显示每个堆栈的堆栈依赖项信息。  
 *默认值*：`false`

## 示例
<a name="ref-cli-cmd-list-examples"></a>

### 列出 CDK 应用程序“node bin/main.js”中的所有堆栈
<a name="ref-cli-cmd-list-examples-1"></a>

```
$ cdk list --app='node bin/main.js'
Foo
Bar
Baz
```

### 列出所有堆栈，包括每个堆栈的 AWS 环境详细信息
<a name="ref-cli-cmd-list-examples-"></a>

```
$ cdk list --app='node bin/main.js' --long
-
    name: Foo
    environment:
        name: 000000000000/bermuda-triangle-1
        account: '000000000000'
        region: bermuda-triangle-1
-
    name: Bar
    environment:
        name: 111111111111/bermuda-triangle-2
        account: '111111111111'
        region: bermuda-triangle-2
-
    name: Baz
    environment:
        name: 333333333333/bermuda-triangle-3
        account: '333333333333'
        region: bermuda-triangle-3
```