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

# sam init
<a name="sam-cli-command-reference-sam-init"></a>

此頁面提供 AWS Serverless Application Model Command Line Interface (AWS SAM CLI) `sam init`命令的參考資訊。
+ 如需 的簡介 AWS SAM CLI，請參閱 [什麼是 AWS SAM CLI？](what-is-sam-overview.md#what-is-sam-cli)
+ 如需使用 AWS SAM CLI`sam init`命令的文件，請參閱 [在 中建立您的應用程式 AWS SAM](using-sam-cli-init.md)。

`sam init` 命令提供選項來初始化新的無伺服器應用程式。

## Usage
<a name="sam-cli-command-reference-sam-init-usage"></a>

```
$ sam init <options>
```

## 選項
<a name="sam-cli-command-reference-sam-init-options"></a>

`--app-template TEXT`  <a name="sam-cli-command-reference-sam-init-options-app-template"></a>
您要使用之受管應用程式範本的識別符。如果您不確定，請呼叫 ，`sam init`而不使用互動式工作流程的選項。  
如果`--no-interactive`已指定 `--location` 且未提供 ，則需要此參數。  
此參數僅適用於 0. AWS SAM CLI30.0 版和更新版本。使用舊版指定此參數會導致錯誤。

`--application-insights | --no-application-insights`  <a name="sam-cli-command-reference-sam-init-options-application-insights"></a>
 為您的應用程式啟用 Amazon CloudWatch Application Insights 監控。如需詳細資訊，請參閱 [使用 CloudWatch Application Insights 監控無 AWS SAM 伺服器應用程式](monitor-app-insights.md)。  
 預設選項為 `--no-application-insights`。

`--architecture, -a [ x86_64 | arm64 ]`  <a name="sam-cli-command-reference-sam-init-options-architecture"></a>
應用程式 Lambda 函數的指示集架構。指定 `x86_64`或 之一`arm64`。

`--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]`  <a name="sam-cli-command-reference-sam-init-options-base-image"></a>
您應用程式的基礎映像。此選項僅適用於套件類型為 時`Image`。  
如果指定 `--no-interactive` 、`--package-type`指定為 且未`--location`指定 `Image`，則需要此參數。

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-init-options-config-env"></a>
在要使用的組態檔案中指定預設參數值的環境名稱。預設值為「預設值」。如需關於組態檔案的詳細資訊，請參閱 [AWS SAM CLI 組態檔案](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-sam-init-options-config-file"></a>
組態檔案的路徑和檔案名稱，其中包含要使用的預設參數值。預設值為專案目錄根目錄中的 "samconfig.toml"。如需關於組態檔案的詳細資訊，請參閱 [AWS SAM CLI 組態檔案](serverless-sam-cli-config.md)。

`--debug`  <a name="sam-cli-command-reference-sam-init-options-debug"></a>
開啟偵錯記錄以列印 產生的偵錯訊息 AWS SAM CLI，並顯示時間戳記。

`--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]`  <a name="sam-cli-command-reference-sam-init-options-dependency-manager"></a>
Lambda 執行時間的相依性管理員。

`--extra-content`  <a name="sam-cli-command-reference-sam-init-options-extra-content"></a>
覆寫範本`cookiecutter.json`組態中的任何自訂參數，例如 `{"customParam1": "customValue1", "customParam2":"customValue2"}`。

`--help, -h`  <a name="sam-cli-command-reference-sam-init-options-help"></a>
顯示此訊息並結束。

`--location, -l TEXT`  <a name="sam-cli-command-reference-sam-init-options-location"></a>
範本或應用程式位置 (Git、Mercurial、HTTP/HTTPS、.zip 檔案、路徑）。  
如果指定 `--no-interactive` 且`--app-template`未提供 `--runtime`、 和 `--name`，則需要此參數。  
對於 Git 儲存庫，您必須使用儲存庫根的位置。  
對於本機路徑，範本必須是 .zip 檔案或 [Cookiecutter](https://cookiecutter.readthedocs.io/en/latest/README.html) 格式。

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-init-options-name"></a>
要產生為目錄的專案名稱。  
如果`--no-interactive`已指定 `--location` 且未提供 ，則需要此參數。

`--no-input`  <a name="sam-cli-command-reference-sam-init-options-no-input"></a>
停用 Cookiecutter 提示，並接受範本組態中定義的 vcf預設值。

`--no-interactive`  <a name="sam-cli-command-reference-sam-init-options-no-interactive"></a>
停用啟動參數的互動式提示，如果遺失任何必要值，則失敗。

`--output-dir, -o PATH`  <a name="sam-cli-command-reference-sam-init-options-output-dir"></a>
已初始化應用程式輸出的位置。

`--package-type [ Zip | Image ]`  <a name="sam-cli-command-reference-sam-init-options-package-type"></a>
範例應用程式的套件類型。 `Zip`會建立 .zip 檔案封存，並`Image`建立容器映像。

`--runtime, -r [ dotnet8 | dotnet6 | java25 | java21 | java17 | java11 | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.4 | ruby3.3 | ruby3.2 ]`  <a name="sam-cli-command-reference-sam-init-options-runtime"></a>
應用程式的 Lambda 執行時間。此選項僅適用於套件類型為 時`Zip`。  
如果指定 `--no-interactive` 、`--package-type`指定為 且未`--location`指定 `Zip`，則需要此參數。

`--save-params`  <a name="sam-cli-command-reference-sam-init-options-save-params"></a>
將您在命令列提供的參數儲存至 AWS SAM 組態檔案。

`--tracing | --no-tracing`  <a name="sam-cli-command-reference-sam-init-options-tracing"></a>
為您的 Lambda 函數啟用 AWS X-Ray 追蹤。

## 範例
<a name="sam-cli-command-reference-sam-init-examples"></a>

如需使用 `sam init` 子命令的詳細範例和深入演練，請參閱 [在 中建立您的應用程式 AWS SAM](using-sam-cli-init.md)。