# LightEdit 模式

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

当需要编辑一个文件而不想在 IntelliJ IDEA 中创建或加载整个项目时，可以使用  LightEdit  模式。

请注意，LightEdit 模式作为类似文本的编辑器运行，不支持常见的 IDE 编辑器功能，例如代码补全或代码导航。 不过，可以导航到特定代码行（ `Ctrl+G` (Windows), `⌘ L` (macOS), `⌘ G` (IntelliJ IDEA Classic (macOS)), `⌘ L` (macOS System Shortcuts), `Ctrl+G` (XWin), `Ctrl+G` (GNOME), `Ctrl+G` (KDE), `Alt+G` (Emacs), `Ctrl+G` (Sublime Text), `⌃ G` (Sublime Text (macOS)), `Ctrl+G` (Visual Studio), `⌘ G` (Visual Studio (macOS)), `Ctrl+G` (NetBeans), `Ctrl+L` (Eclipse), `⌘ L` (Eclipse (macOS))）、折叠或展开部分代码、检查和更改文件编码，以及重新格式化代码。

![LightEdit 模式](https://resources.jetbrains.com.cn/help/img/idea/2026.3/light_editor_mode.png)

## 在 LightEdit 中打开文件

您可以使用多种方法在 LightEdit 模式下打开文件。

> **Note:**
> 如果您使用的是 Toolbox 安装的 IntelliJ IDEA，请确保您已从 Toolbox 1.9 版本安装了 IntelliJ IDEA。 如果使用的是 IntelliJ IDEA 的独立安装，请先创建命令行启动器（  `工具 | 创建命令行启动器…` ）。

Procedure: 从命令行打开文件

* 从命令行打开文件，在文件名称之前使用短  `-e`  或长  `--edit`  选项：

Windows:

```CONSOLE
idea.bat -e README.md

```

可以在 [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)下的  `bin`  中找到用于运行 IntelliJ IDEA 的可执行文件。 要将此可执行文件用作命令行启动器，请按照 [命令行界面](working-with-the-ide-features-from-command-line.html) 中的说明将其添加到系统  `路径` 。

macOS:

```PLAINTEXT
idea -e README.md

```

默认情况下，IntelliJ IDEA 不提供命令行启动器。 有关为 IntelliJ IDEA 创建启动脚本的更多信息，请参阅 [命令行界面](working-with-the-ide-features-from-command-line.html)。

Unix / Linux:

```PLAINTEXT
idea.sh -e README.md

```

可以在 [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)下的  `bin`  中找到用于运行 IntelliJ IDEA 的脚本。 要将此脚本用作命令行启动器，请按照 [命令行界面](working-with-the-ide-features-from-command-line.html) 中的说明将其添加到系统  `路径` 。

> **Tip:**
> 可以在完整编辑模式下从命令行打开文件。 有关更多信息，请参阅 [从命令行打开文件](opening-files-from-command-line.html)。

Procedure: 使用 wait 开关打开并编辑文件

可以中断命令行中的进程，并将终端置于等待状态，直到在 LightEdit 模式中完成文件编辑。 例如，在命令行中工作并运行 Git 提交流程时，可以暂停终端，并使用 LightEdit 模式编写提交消息。

* 在文件名称之前使用  `-e` （或  `--edit` ）和  `--wait`  选项，从命令行打开文件。

Windows:

```CONSOLE
idea.bat -e --wait README.md

```

可以在 [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)下的  `bin`  中找到用于运行 IntelliJ IDEA 的可执行文件。 要将此可执行文件用作命令行启动器，请按照 [命令行界面](working-with-the-ide-features-from-command-line.html) 中的说明将其添加到系统  `路径` 。

macOS:

```PLAINTEXT
idea -e --wait README.md

```

默认情况下，IntelliJ IDEA 不提供命令行启动器。 有关为 IntelliJ IDEA 创建启动脚本的更多信息，请参阅 [命令行界面](working-with-the-ide-features-from-command-line.html)。

Unix / Linux:

```PLAINTEXT
idea.sh -e --wait README.md

```

可以在 [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)下的  `bin`  中找到用于运行 IntelliJ IDEA 的脚本。 要将此脚本用作命令行启动器，请按照 [命令行界面](working-with-the-ide-features-from-command-line.html) 中的说明将其添加到系统  `路径` 。

IntelliJ IDEA 会在 LightEdit 模式中打开文件，并显示一条通知，指示命令行正在等待文件关闭。

![命令行等待通知](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_wait_mode.png)

Procedure: 在 LightEdit 中打开一个空的 IDE 窗口

可以在 LightEdit 模式中打开一个空的 IDE 窗口。 随后，可以使用主菜单中的  `文件 | 打开`  选项打开要编辑的文件。

* 根据操作系统，使用  `-e` （或  `--edit` ）选项启动 IDE。

Windows:

```CONSOLE
idea.bat -e

```

可以在 [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)下的  `bin`  中找到用于运行 IntelliJ IDEA 的可执行文件。 要将此可执行文件用作命令行启动器，请按照 [命令行界面](working-with-the-ide-features-from-command-line.html) 中的说明将其添加到系统  `路径` 。

macOS:

```PLAINTEXT
idea -e

```

默认情况下，IntelliJ IDEA 不提供命令行启动器。 有关为 IntelliJ IDEA 创建启动脚本的更多信息，请参阅 [命令行界面](working-with-the-ide-features-from-command-line.html)。

Unix / Linux:

```PLAINTEXT
idea.sh -e

```

可以在 [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)下的  `bin`  中找到用于运行 IntelliJ IDEA 的脚本。 要将此脚本用作命令行启动器，请按照 [命令行界面](working-with-the-ide-features-from-command-line.html) 中的说明将其添加到系统  `路径` 。

## 在 LightEdit 中处理代码

尽管 LightEdit 模式不支持所有 IntelliJ IDEA 编辑器编码辅助功能，仍可以使用基本编辑功能和菜单选项。

* 使用主菜单打开最近的文件、显示行号、显示空格、重新格式化代码、扩展代码选区等。 当您编辑文件时，标签上的蓝色指示表示文件内容已更改。 ![LightEdit 模式：已更改文件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/lightEditMode.png)

* 当外部更改被应用于您正在处理的文件时，您可以通过从主菜单中选择 `文件｜从磁盘重新加载` 来更新它。

* 使用状态栏转到所需的行，在文件受版本控制时检查当前分支，或启用 [自动保存](#ws_lightedit_turn_on_autosave) 模式。

* 请使用上下文菜单粘贴或折叠您的代码，并切换到列选择模式。 ![LightEditor 上下文菜单](https://resources.jetbrains.com.cn/help/img/idea/2026.3/lightEdit_context_menu.png)

## 打开自动保存

Procedure:

* 点击状态栏上的   自动保存：关闭  ，然后在打开的弹出窗口中选择   自动保存更改  。

## 退出 LightEdit 模式

您可以退出 LightEdit 模式并从编辑单个文件切换到处理整个项目。

如果文件已经是某个项目的一部分，该项目将打开。 如果文件未与任何项目关联，系统会提示选择一个用于打开文件的项目。 如果选择的文件夹不是项目，IDE 将在该文件夹中创建一个新项目。

Procedure:

* 在 LightEdit 模式的状态栏上，点击   访问完整 IDE   并选择   在项目中打开当前文件…  。

![访问完整 IDE](https://resources.jetbrains.com.cn/help/img/idea/2026.3/light_edit_access_ide.png)

* 按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))并选择   在项目中打开文件…  。

* 从主菜单中选择  `文件 | 在项目中打开文件…` 。

## See also

### 相关

[从命令行打开文件](opening-files-from-command-line.html).

