临时文件
有时您可能需要在项目上下文之外创建临时笔记或草拟一些代码。 与其切换到其他应用程序，您可以使用 scratch files和 scratch buffers。
临时文件 是功能齐全的文件，可以运行和调试，支持语法高亮、代码补全以及相应文件类型的所有其他功能。 例如，在一个项目中工作时，您可能会想到一个以后可以在另一个项目中使用的方法。 您可以创建一个方法草稿的临时文件，该文件不会存储在您的项目目录中，但在您处理任何其他项目时可以打开。 您可以使用临时文件来草拟代码结构、 HTTP 请求 、JSON 文档等。
Scratch buffers 是没有任何编码辅助功能的简单文本文件。 临时缓冲区可用于简单的任务列表和便条。 它们也不会存储在项目目录中，可以从任何其他项目中打开。 您可以创建最多五个具有默认名称的暂存缓冲区，这些缓冲区通过清除内容进行轮换和重复使用。
创建临时文件
请前往 或按 Ctrl+Alt+Shift+Insert。
或者，在 Project 工具窗口（Alt+1 ）中，点击工具栏上的
并选择 。选择临时文件的语言。
相同类型的草稿文件会自动编号，并添加到 项目视图 的 临时文件和控制台 目录中。
或者，您可以在编辑器中用当前选择的内容创建一个新的 scratch 文件。 选择一些文本或代码，按 Alt+Enter 然后选择 从选区创建新的临时文件。 PhpStorm 将尝试检测所选片段的语言，并使用适当的类型和扩展名。 如果无法检测到所选内容的语言，PhpStorm 将创建与原始文件相同类型和扩展名的文件。
创建一个暂存缓冲区
没有专门的菜单项用于创建新的暂存缓冲区，但您可以使用 查找操作 弹出窗口 Ctrl+Shift+A 并运行 新建临时缓冲区 操作。
您还可以为 新建临时缓冲区 操作添加快捷键，如 键盘快捷键 中所述。
PhpStorm 创建一个名为 buffer1.txt 的文本文件。
您创建的下一个暂存缓冲区将命名为 buffer2.txt ，依此类推，直到 buffer5.txt 。 当 PhpStorm 达到该限制时，它将重新创建 buffer1.txt 并建议清除其内容。 如果您想确保 PhpStorm 在您已有五个后不会清空临时缓冲区，您可以重命名它。
查看所有暂存文件和缓冲区
打开 项目视图 并展开 。
使用 Find Action 弹窗 Ctrl+Shift+A 调用 显示临时文件 操作，并在弹窗中查看所有可用的 scratch 文件：
在多个 PHP 版本中运行临时文件
PhpStorm 与 3v4l.org 集成，允许您使用多个 PHP 版本同时运行 PHP 临时文件中的代码，或即时切换版本。 在后台，PhpStorm 会将临时文件中的代码片段上传到 3v4l.org 服务，并将输出带回 IDE。 无需额外的步骤来安装或配置该服务。
在 IDE 中运行 3v4l.org 上的 PHP 代码
通过以下任一方式在临时文件编辑器中打开代码片段：
在 项目视图 中展开 并打开一个现有的临时文件。
从项目文件创建一个新的临时文件。 为此，请在编辑器中选择代码片段，按 Alt+Enter ，然后选择 从选区创建新的临时文件。
PHP 临时文件的编辑器窗口顶部带有一个 3v4l.org 工具栏。
从工具栏的列表中选择特定的 PHP 版本（或保留默认的 所有版本 选项），然后单击
。 当出现提示时，确认是否要将临时文件的内容上传到 3v4l.org 并将其设为公开。3v4l.org 运行您的代码（请参阅工具栏上的 3v4l.org 链接），并在编辑器中显示带有执行结果的预览窗口。
要在编辑器和预览之间切换，请单击工具栏上的
、 
或 
。
临时文件和缓冲区的位置
默认情况下，PhpStorm 会将临时文件和缓冲区存储在 IDE 配置目录 的 临时文件 下。 它们可用于使用此配置目录的任何 IDE 和项目。
- 语法
%APPDATA%\JetBrains\<product><version>
- 示例
C:\Users\JohnS\AppData\Roaming\JetBrains\PhpStorm2025.2
- 语法
~/Library/Application Support/JetBrains/<product><version>
- 示例
~/Library/Application Support/JetBrains/PhpStorm2025.2
- 语法
~/.config/JetBrains/<product><version>
- 示例
~/.config/JetBrains/PhpStorm2025.2
要更改 临时文件和控制台 目录的位置，请使用 idea.scratch.path 平台属性。 要更改 临时文件 目录的位置，请使用 idea.scratch.path/scratches 平台属性。 欲了解更多信息，请参阅 高级配置。
将草稿文件包含到您的项目中
如果一个临时文件变成了您想在项目中使用的内容，请将其移动到项目结构中所需的目录。
在编辑器中打开一个 scratch 文件或在 项目视图 中的 目录下选择它，按 F6 ，然后在您的项目中选择目标目录。
将暂存文件从 项目视图 中的 目录拖动到项目中的目标目录。
在 项目视图 中选择 目录中的一个 scratch 文件并按 Ctrl+X ，然后选择您项目中的目标目录并按 Ctrl+V。
更改草稿文件或缓冲区的语言
在 Project工具窗口中，打开 。
右键点击临时文件或缓冲区，然后点击 更改语言。
选择所需的语言。 您可以开始键入语言名称以缩小列表范围。
查看草稿文档
在 Project 工具窗口中选择任意 scratch 文件或缓冲区，然后按下 Ctrl+Q 查看包含文件位置、类型、大小、创建时间和修改日期的 快速文档。