# 命令行界面

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

使用 CLion 功能从命令行打开文件和项目、查看差异、合并文件、应用代码风格、格式化和检查源代码。

> **Tip:**
> 有关从 CLion 内部运行命令行工具的更多信息，请参阅 [终端仿真器](terminal-emulator.html)。

## 独立实例启动器

Windows:

[安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)包含用于启动 CLion、对源代码进行格式设置以及运行检查的批处理脚本和可执行文件。 若要在命令提示符  `cmd.exe`  中使用它们，请将 CLion  `bin`  文件夹的位置添加到  `PATH`  环境变量。 例如，如果将 CLion 安装到  `C:\Program Files\JetBrains\%instance%` ，可以使用以下命令：

```CONSOLE
set PATH=%PATH%;C:\Program Files\JetBrains\CLion\bin

```

此命令仅更改当前 shell（当前实例的  `cmd.exe` ）的  `PATH` 环境变量。

要使此更改永久生效：

* 如果正在安装 CLion，请在 将 "bin" 文件夹添加到路径 [安装程序](installation-guide.html#standalone_windows)中选择。

* 或者，使用 Windows 环境变量 对话框，将 IDE 的 bin 目录添加到 `路径` 用户环境变量中。

* 否则，如果偏好命令行解决方案，可以使用 PowerShell： ```POWERSHELL [Environment]::SetEnvironmentVariable('PATH', $env:PATH + ';C:\Program Files\JetBrains\IntelliJ IDEA\bin', 'User') ```

配置好  `PATH` 变量后，您可以在命令提示符的任意工作目录中运行该可执行文件：

```CONSOLE
clion64.exe

```

或者，您可以使用批处理脚本：

```CONSOLE
clion.bat

```

macOS:

要在 shell 中运行 CLion，请使用  `open`  命令并带上以下选项：

`-a`
: 指定应用程序。

`-n`
: 即使已有一个实例在运行，也要打开一个新的应用实例。

`--args`
: 指定要传递给应用程序的其他参数。

例如，您可以使用以下命令运行  `CLion.app` ：

```SHELL
open -na "CLion.app"

```

> **Note:**
> 如果 CLion 不在默认  `/Applications` 目录中，请指定其完整路径。

您可以在来自您的  `PATH` 环境变量的目录中使用此命令创建一个 shell 脚本。 例如，创建文件  `/usr/local/bin/clion` ，内容如下：

```PLAINTEXT
#!/bin/sh

open -na "CLion.app" --args "$@"

```

确保您有权限执行脚本，并且由于  `/usr/local/bin` 默认应在  `PATH` 环境变量中，因此您应该能够在 shell 中的任何位置运行  `clion` 。

如果您没有执行脚本的权限，请运行以下命令：

```SHELL
chmod +x /usr/local/bin/clion

```

Linux:

在 Linux 上， [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)包含位于  `bin`  下的启动器 shell 脚本  `clion.sh` 。 例如，如果将 CLion 安装到  `/opt/clion` ，可以使用以下命令运行脚本：

```SHELL
/opt/clion/bin/clion.sh

```

您可以在  `PATH`  环境变量中的目录中创建一个指向 launcher 脚本的符号链接。 例如，如果您想在  `/usr/local/bin`  中创建一个名为  `clion`  的链接，请运行以下命令：

```SHELL
ln -s /opt/clion/bin/clion.sh /usr/local/bin/clion

```

由于  `/usr/local/bin`  应该默认在  `PATH`  环境变量中，您应该能够在 shell 的任何地方运行  `clion`  命令。

## 由 Toolbox App 生成的 Shell 脚本

如果您使用 [Toolbox App](https://www.jetbrains.com/zh-cn/toolbox/app/) 安装和管理 JetBrains 产品，您可以使用 shell 脚本从命令行启动您的 IDE。

Toolbox App 会自动生成 shell 脚本并将它们放置到以下文件夹：

Windows:

```GENERIC
%LOCALAPPDATA%\JetBrains\Toolbox\scripts
```

默认情况下，Toolbox App 会将 shell 脚本放入系统  `PATH`  环境变量中的某个目录，因此可以从任意工作目录将脚本名称作为命令运行，以启动 CLion。

Procedure: 更改 shell 脚本位置

1. 打开 Toolbox App，点击右上角的   Toolbox App 菜单  图标，并选择   设置  。

![Toolbox App 菜单图标](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox_app_menu_icon.png)

2. 在   设置   选项卡上，展开   工具   部分，并在   Shell 脚本位置   字段中指定其他文件夹。

![更改 shell 脚本的位置](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox_app_shellscript_location_win.png)

Procedure: 重命名 shell 脚本

如果您有多个版本的相同 IDE，Toolbox App 会为每个版本生成一个具有唯一名称的 shell 脚本。 可以在此特定实例的设置中更改 IDE 实例的 shell 脚本名称。

1. 打开 Toolbox App。

2. 点击 IDE 实例旁边的 ![工具操作](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg)，然后选择   设置  。

3. 在   配置   部分底部，更改   Shell 脚本名称   字段。

![Toolbox App CLion 设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_app_instance_settings_win.png)

macOS:

```GENERIC
/usr/local/bin
```

或

```GENERIC
~/Library/Application Support/JetBrains/Toolbox/scripts
```

默认情况下，Toolbox App 会将 shell 脚本放入系统  `PATH`  环境变量中的某个目录，因此可以从任意工作目录将脚本名称作为命令运行，以启动 CLion。

Procedure: 更改 shell 脚本位置

1. 打开 Toolbox App，点击右上角的   Toolbox App 菜单  图标，并选择   设置  。

![Toolbox App 菜单图标](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox_app_menu_icon.png)

2. 在   设置   选项卡上，展开   工具   部分，并在   Shell 脚本位置   字段中指定其他文件夹。

![更改 shell 脚本的位置](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox_app_shellscript_location.png)

Procedure: 重命名 shell 脚本

如果您有多个版本的相同 IDE，Toolbox App 会为每个版本生成一个具有唯一名称的 shell 脚本。 可以在此特定实例的设置中更改 IDE 实例的 shell 脚本名称。

1. 打开 Toolbox App。

2. 点击 IDE 实例旁边的 ![工具操作](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg)，然后选择   设置  。

3. 在   配置   部分底部，更改   Shell 脚本名称   字段。

![Toolbox App CLion 设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_app_instance_settings.png)

Linux:

```GENERIC
~/.local/share/JetBrains/Toolbox/scripts
```

默认情况下，Toolbox App 会将 shell 脚本放入系统  `PATH`  环境变量中的某个目录，因此可以从任意工作目录将脚本名称作为命令运行，以启动 CLion。

Procedure: 更改 shell 脚本位置

1. 打开 Toolbox App，点击右上角的   Toolbox App 菜单  图标，并选择   设置  。

![Toolbox App 菜单图标](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox_app_menu_icon.png)

2. 在   设置   选项卡上，展开   工具   部分，并在   Shell 脚本位置   字段中指定其他文件夹。

![更改 shell 脚本的位置](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox_app_shellscript_location_linux.png)

Procedure: 重命名 shell 脚本

如果您有多个版本的相同 IDE，Toolbox App 会为每个版本生成一个具有唯一名称的 shell 脚本。 可以在此特定实例的设置中更改 IDE 实例的 shell 脚本名称。

1. 打开 Toolbox App。

2. 点击 IDE 实例旁边的 ![工具操作](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg)，然后选择   设置  。

3. 在   配置   部分底部，更改   Shell 脚本名称   字段。

![Toolbox App CLion 设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_app_instance_settings_linux.png)

## 命令行参数

启动脚本接受命令、选项和其他参数以修改其行为。 如果没有任何参数，脚本将启动 CLion。 如果您指定文件或目录的路径，CLion将会打开指定的文件或目录。 欲了解更多信息，请参阅 [从命令行打开文件](opening-files-from-command-line.html)。

### 命令

`diff`
: 打开差异查看器以查看两个指定文件之间的区别。
:
:
:
: 欲了解更多信息，请参阅 [命令行比较文件](command-line-differences-viewer.html)。

`merge`
: 打开   合并  对话框以合并指定文件。
:
:
:
: 欲了解更多信息，请参阅 [从命令行合并文件](command-line-merge-tool.html)。

`format`
: 将代码样式格式应用到指定文件。
:
:
:
: 欲了解更多信息，请参阅 [从命令行格式化文件](command-line-formatter.html)。

`inspect`
: 在指定项目上执行代码检查。
:
:
:
: 欲了解更多信息，请参阅 [从命令行运行代码检查](command-line-code-inspector.html)。

`installPlugins`
: 通过插件 ID 从 [JetBrains Marketplace](https://plugins.jetbrains.com/) 或 [自定义插件库](managing-plugins.html#repos) 安装插件。
:
:
:
: 欲了解更多信息，请参阅 [从命令行安装插件](install-plugins-from-the-command-line.html)。

### 选项

`nosplash`
: 加载 CLion 时不显示启动画面。

`dontReopenProjects`
: 不要重新打开项目并显示欢迎屏幕。 这可以帮助当一个打开的项目崩溃 CLion。

`disableNonBundledPlugins`
: 在不加载手动安装的插件的情况下启动 CLion。 此选项不会删除或永久禁用插件。 如果您安装的插件使 CLion 崩溃，这可能会有所帮助。 您将能够启动 IDE，并禁用或卸载这个有问题的插件。

`--wait`
: 等待文件关闭后再返回到命令提示符。
:
:
:
: 例如，您可以使用以下命令打开  `file.txt` ：
:
: `clion --wait file.txt`
:
: shell 将一直等待，直到  `file.txt` 关闭。

