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

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

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam init` 命令的参考信息。
+ 有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)
+ 有关使用该 AWS SAMCLI`sam init`命令的文档，请参阅[在中创建您的应用程序 AWS SAM](using-sam-cli-init.md)。

`sam init` 命令提供用于初始化新的无服务器应用程序的选项。

## 用法
<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` ，则需要此参数。  
此参数只在 AWS SAM CLI 版本 0.30.0 及更高版本中提供。对早期版本指定此参数会导致错误。

`--application-insights | --no-application-insights`  <a name="sam-cli-command-reference-sam-init-options-application-insights"></a>
 为您的 CloudWatch 应用程序激活 Amazon 应用程序见解监控。要了解更多信息，请参阅[使用 “ CloudWatch 应用程序见解” 监控您的 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` 被指定为 `Image`，且未指定 `--location`，则需要此参数。

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-init-options-config-env"></a>
在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-sam-init-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为“samconfig.toml”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](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` 且未提供 `--runtime`、`--name` 和 `--app-template`，则需要此参数。  
对于 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 提示并接受模板配置中定义的 vcfdefault 值。

`--no-interactive`  <a name="sam-cli-command-reference-sam-init-options-no-interactive"></a>
禁用 init 参数的交互式提示，如果缺少任何必需值，则失败。

`--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` 被指定为 `Zip`，且未指定 `--location`，则需要此参数。

`--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)。