

這是 AWS CDK v2 開發人員指南。較舊的 CDK v1 已於 2022 年 6 月 1 日進入維護，並於 2023 年 6 月 1 日結束支援。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

從範本建立新的 AWS CDK 專案。

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

```
$ cdk init <arguments> <options>
```

## 引數
<a name="ref-cli-cmd-init-args"></a><a name="ref-cli-cmd-init-args-template-type"></a>

 **範本類型**   
初始化新 CDK 專案的 CDK 範本類型。  
+  `app` – CDK 應用程式的範本。
+  `lib` – AWS 建構程式庫的範本。
+  `sample-app` – 包含一些建構的範例 CDK 應用程式。
 *有效值*：`app`、`lib`、 `sample-app`

## 選項
<a name="ref-cli-cmd-init-options"></a>

如需適用於所有 CDK CLI 命令的全域選項清單，請參閱[全域選項](ref-cli-cmd.md#ref-cli-cmd-options)。<a name="ref-cli-cmd-init-options-generate-only"></a>

 `--generate-only <BOOLEAN>`   
指定此選項可在不啟動其他操作的情況下產生專案檔案，例如設定 git 儲存庫、安裝相依性或編譯專案。  
 *預設值*：`false`<a name="ref-cli-cmd-init-options-help"></a>

 `--help, -h <BOOLEAN>`   
顯示命令的`cdk init`命令參考資訊。<a name="ref-cli-cmd-init-options-language"></a>

 `--language, -l <STRING>`   
用於新專案的語言。此選項可在專案的`cdk.json`組態檔案中設定，或在本機開發機器`~/.cdk.json`上的 設定。  
 *有效值*：`csharp`、`fsharp`、`go`、`java`、`javascript`、`python`、 `typescript`<a name="ref-cli-cmd-init-options-list"></a>

 `--list <BOOLEAN>`   
列出可用的範本類型和語言。

## 範例
<a name="ref-cli-cmd-init-examples"></a>

### 列出可用的範本類型和語言
<a name="ref-cli-cmd-init-examples-1"></a>

```
$ cdk init --list
Available templates:
* app: Template for a CDK Application
   └─ cdk init app --language=[csharp|fsharp|go|java|javascript|python|typescript]
* lib: Template for a CDK Construct Library
   └─ cdk init lib --language=typescript
* sample-app: Example CDK Application with some constructs
   └─ cdk init sample-app --language=[csharp|fsharp|go|java|javascript|python|typescript]
```

### 從程式庫範本在 TypeScript 中建立新的 CDK 應用程式
<a name="ref-cli-cmd-init-examples-2"></a>

```
$ cdk init lib --language=typescript
```