本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
sam init
本页提供 Amazon Serverless Application Model 命令行界面的参考信息 (Amazon SAM CLI) sam init 命令。
-
有关简介 Amazon SAM CLI，请参阅 什么是 Amazon SAM CLI?
-
有关使用方法的文档 Amazon SAM CLI
sam init命令，请参阅在中创建您的应用程序 Amazon SAM。
sam init 命令提供用于初始化新的无服务器应用程序的选项。
使用量
$sam init<options>
选项
--app-templateTEXT-
您要使用的托管应用程序模板的标识符。如果您不确定，请在没有交互式工作流选项的情况下调用
sam init。如果指定了
--no-interactive，且不提供--location，则需要此参数。此参数仅在以下版本中可用 Amazon SAM CLI 版本 0.30.0 及更高版本。对早期版本指定此参数会导致错误。
--application-insights | --no-application-insights-
为您的 CloudWatch 应用程序激活 Amazon 应用程序见解监控。要了解更多信息，请参阅 使用 “ CloudWatch 应用程序见解” 监控您的 Amazon SAM 无服务器应用程序。
默认选项是
--no-application-insights。 --architecture, -a[ x86_64 | arm64 ]-
应用程序的 Lambda 函数的指令集架构。指定
x86_64或arm64。 --base-image[ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-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.3-base | amazon/ruby3.2-base ]-
应用程序的基本映像。当软件包类型为
Image时，此选项才适用。如果已指定
--no-interactive，--package-type被指定为Image，且未指定--location，则需要此参数。 --config-envTEXT-
在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息，请参阅 Amazon SAM CLI 配置文件。
--config-filePATH-
包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为“samconfig.toml”。有关配置文件的详细信息，请参阅 Amazon SAM CLI 配置文件。
--debug-
开启调试日志记录以打印调试消息 Amazon SAM CLI 生成，并显示时间戳。
--dependency-manager, -d[ gradle | mod | maven | bundler | npm | cli-package | pip ]-
Lambda 运行时的依赖项管理器。
--extra-content-
覆盖模板的
cookiecutter.json配置中的任何自定义参数，例如{"customParam1": "customValue1", "customParam2":"customValue2"}。 --help, -h-
显示此消息并退出。
--location, -lTEXT-
模板或应用程序的位置（Git、Mercurial、HTTP/HTTPS、.zip 文件、路径）。
如果指定了
--no-interactive且未提供--runtime、--name和--app-template，则需要此参数。对于 Git 存储库，必须使用存储库根目录的位置。
对于本地路径，模板必须为 .zip 文件或 Cookiecutter
格式。 --name, -nTEXT-
要生成为目录的项目的名称。
如果指定了
--no-interactive，且不提供--location，则需要此参数。 --no-input-
禁用 Cookiecutter 提示并接受模板配置中定义的 vcfdefault 值。
--no-interactive-
禁用 init 参数的交互式提示，如果缺少任何必需值，则失败。
--output-dir, -oPATH-
已初始化的应用程序的输出位置。
--package-type[ Zip | Image ]-
示例应用程序的软件包类型。
Zip会创建 .zip 文件存档，Image会创建容器映像。 --runtime, -r[ dotnet8 | dotnet6 | java21 | java17 | java11 | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.3 | ruby3.2 ]-
应用程序的 Lambda 运行时。当软件包类型为
Zip时，此选项才适用。如果已指定
--no-interactive，--package-type被指定为Zip，且未指定--location，则需要此参数。 --save-params-
将您在命令行中提供的参数保存到 Amazon SAM 配置文件中。
--tracing | --no-tracing-
激活您的 Lambda 函数的 Amazon X-Ray 跟踪。
示例
有关使用 sam init 子命令的详细示例和深入演练，请参阅在中创建您的应用程序 Amazon SAM。