# Play Framework

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件：   Scala  ： [安装方法](get-started-with-scala.html#scala_plugin)

> **Note:**
> IntelliJ IDEA 支持 Play 版本 2.4 及更高版本。
>
>
>
> 自 Play 2.9 起，可以使用 Scala 3

让我们看看在 IntelliJ IDEA 中生成一个 Play 项目的以下常见场景：

* 如果您已经有一个现成的 Play 项目，您可以导入它或从版本控制中检出。 在这种情况下，您可以按照常规程序进行 [importing](import-project-or-module-wizard.html#import-project)或克隆项目。

* 如果您不熟悉 Play Framework 并且想学习如何使用它，可以通过 IntelliJ IDEA 创建一个 Play 项目，该项目将生成一个可执行的应用程序。

* 如果想手动添加对 [Play 框架](https://www.playframework.com/documentation/2.8.x/NewApplication) 的支持，请创建一个 [sbt](sbt-support.html) 项目。

## 创建一个新的 Play 项目

Procedure:

1. 启动 IntelliJ IDEA。

在 IntelliJ IDEA 主屏幕上，点击  `新建 | 项目` 。 如果已经打开了项目，请从主菜单中选择  `文件 | 新建项目` 。

2. 从左侧的选项中，在   生成器   节点下，选择   Play  。

![新建项目对话框](https://resources.jetbrains.com/help/img/idea/2026.3/play_create.png)

3. 请按照向导中的步骤操作，并点击   创建  。

IntelliJ IDEA 会生成具有适当结构、依赖项和应用程序可执行文件的 Play 项目。

![项目编辑器和工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/ready_play_project.png)

## 打开一个已有的 Play 项目

Procedure:

1. 在欢迎屏幕上，选择   打开  。 或者，在主菜单中转到  `文件 | 打开` 。

2. 在打开的对话框中，找到您的项目，如果这是一个 sbt 项目，请选择  `build.sbt` 文件并点击   打开  。

3. 在打开的对话框中，点击   作为项目打开  。

IntelliJ IDEA 打开项目并加载所有必要的依赖项。

如果您的项目不是 sbt 项目，请参考 [import project](import-project-or-module-wizard.html#import-project)部分。

## 运行并调试 Play 应用程序

Procedure:

1. 如果您想运行该应用程序：

1.  在项目工具窗口中，右键点击应用程序。

2.  在上下文菜单中，选择   运行 Play 应用  。

2. 如果您需要访问   运行/调试配置   对话框：

1.  前往  `运行 | 编辑配置` 。

2.  点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 并选择   Play 应用   以创建新的配置。

3.  指定运行/调试配置设置。 默认设置足以用于运行和调试目的。

![运行/调试配置用于 Play](https://resources.jetbrains.com/help/img/idea/2026.3/play_run_debug.png)

4.  在主工具栏上，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg) 图标以运行或点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) 图标以调试您的应用程序。

您可以在默认浏览器中检查您的应用程序输出  `http://localhost:9000` 。 如果您想要停止服务器会话，请按  `Alt+D` （对于 macOS，请按  `Cmd+P` ）。

![正在运行的 Play 应用程序](https://resources.jetbrains.com/help/img/idea/2026.3/play_server_display.png)

## 使用 Play 设置

您可以使用 Play 设置来配置编译器选项并配置路由文件的格式。 您还可以查看和编辑默认模板导入列表。

Procedure:

1. 请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 并从左侧选项中选择  `语言   框架 | Play` 。

2. 根据您想要配置的设置，请在   Play  设置页面上选择相应的选项卡并调整设置。 使用   其他  选项卡检查和编辑从描述符中检索到的模板导入列表，当您刷新项目时。

![播放设置](https://resources.jetbrains.com/help/img/idea/2026.3/play_settings.png)

要手动添加模板、删除或编辑现有模板，请选择   手动选择模板导入   选项，使   导入   部分变为活动状态，并相应调整导入列表。