PyCharm 2025.3 Help

草稿文件

有时,您可能需要在项目上下文之外创建临时笔记或草拟一些代码。 与其切换到其他应用,您可以使用 草稿文件草稿缓冲区

  • 草稿文件是功能完备、可运行且可调试的文件,支持语法高亮、代码补全以及相应文件类型的所有其他功能。 例如,在处理某个项目时,您可能想出一个方法的思路,之后可以在另一个项目中使用。 您可以创建一个包含该方法草稿的草稿文件。它不会存储在您的项目目录中,但在处理任何其他项目时都可以打开。 您可以使用草稿文件来草拟代码结构、 HTTP 请求 、JSON 文档等。

  • 草稿缓冲区是没有任何编码辅助功能的简单文本文件。 草稿缓冲区可用于简单的任务列表和个人笔记。 它们同样不会存储在项目目录中,并且可以从任何其他项目中打开。 您最多可以创建 5 个使用默认名称的草稿缓冲区,系统会通过清空内容对它们进行轮换和复用。

创建草稿文件

  1. 转到 文件(F) | 新建(N) | 临时文件 或按 Ctrl+Alt+Shift+Insert

    或者,在 项目 工具窗口(Alt+1 )中,点击工具栏上的 ,然后选择 临时文件

  2. 选择草稿文件的语言。

    相同类型的草稿文件会自动编号,并添加到 项目视图 的 临时文件和控制台 目录中。

或者,您可以使用编辑器中当前选区的内容创建新的草稿文件。 选择部分文本或代码,按 Alt+Enter ,然后选择 从选区创建新的临时文件。 PyCharm 将尝试检测所选片段的语言,并使用相应的类型和扩展名。 如果无法检测所选内容的语言,PyCharm 将创建与原始文件具有相同类型和扩展名的文件。

创建草稿缓冲区

  • 没有用于创建新草稿缓冲区的专用菜单项,但您可以使用 查找操作 弹出窗口 Ctrl+Shift+A 并运行 新建临时缓冲区 操作。

新建草稿缓冲区操作

您还可以按照 配置键盘快捷键 中的说明为 新建临时缓冲区 操作添加快捷键。

PyCharm 会创建一个名为 buffer1.txt 的文本文件。

您创建的下一个草稿缓冲区将命名为 buffer2.txt ,依此类推,直至 buffer5.txt 。 当 PyCharm 达到该上限时,将重新创建 buffer1.txt ,并建议清空其内容。 如果您希望在已有 5 个后确保 PyCharm 不会清空该草稿缓冲区,您可以将其重命名。

查看所有草稿文件和缓冲区

  • 打开 项目视图,展开 临时文件和控制台 | 临时文件

    项目工具窗口中的草稿
  • 使用 查找操作 弹出窗口 Ctrl+Shift+A 调用 显示临时文件 操作,并在弹出窗口中查看所有可用的草稿文件:

    草稿文件弹出窗口

草稿文件和缓冲区的位置

默认情况下,PyCharm 会将草稿文件和缓冲区存储在 临时文件 下的 IDE 配置目录 中。 使用该配置目录的任何 IDE 和项目均可使用它们。

语法

%APPDATA%\JetBrains\<product><version>

示例

C:\Users\JohnS\AppData\Roaming\JetBrains\PyCharm2025.3

语法

~/Library/Application Support/JetBrains/<product><version>

示例

~/Library/Application Support/JetBrains/PyCharm2025.3

语法

~/.config/JetBrains/<product><version>

示例

~/.config/JetBrains/PyCharm2025.3

要更改 临时文件和控制台 目录的位置,请使用 idea.scratch.path 平台属性。 要仅更改 临时文件 目录的位置,请使用 idea.scratch.path/scratches 平台属性。 有关详细信息,请参阅 高级配置

将草稿文件纳入项目

如果某个草稿文件逐渐发展成您希望在项目中使用的内容,请将其移动到项目结构中所需的目录。

  • 在编辑器中打开草稿文件,或在 项目视图 的 临时文件和控制台 | 临时文件 目录下选中它,按 F6 ,然后在项目中选择目标目录。

  • 将草稿文件从 项目视图 的 临时文件和控制台 | 临时文件 目录拖动到项目中的目标目录。

  • 在 项目视图 的 临时文件和控制台 | 临时文件 目录中选择一个草稿文件,按 Ctrl+X ,然后在项目中选择目标目录并按 Ctrl+V

更改草稿文件或缓冲区的语言

  1. 项目 工具窗口中,打开 临时文件和控制台 | 临时文件

  2. 右键点击草稿文件或缓冲区,然后点击 更改语言

  3. 选择所需语言。 您可以开始键入该语言的名称以缩小列表范围。

查看草稿的文档

  • 项目 工具窗口中选择任意草稿文件或缓冲区并按 Ctrl+Q ,以查看包含文件位置、类型、大小、创建日期和修改日期的 快速文档

最后修改日期: 2025年 12月 2日