PyCharm 2025.3 Help

命令行界面

从命令行使用 PyCharm 的功能:打开文件和项目、查看差异、合并文件、应用代码样式、格式化以及检查源代码。

独立实例的启动器

安装目录包含用于启动 PyCharm、格式化源代码以及运行检查的批处理脚本和可执行文件。 要在命令提示符 cmd.exe 中使用它们,请将 PyCharm 的 bin 文件夹位置添加到 PATH 环境变量。 例如,如果您将 PyCharm 安装到 C:\Program Files\JetBrains\PyCharm ,可以使用以下命令:

set PATH=%PATH%;C:\Program Files\JetBrains\PyCharm\bin

此命令仅为当前 Shell ( cmd.exe 的当前实例)更改 PATH 环境变量。 如果您希望为当前用户永久更新它,请运行 setx

setx PATH "%PATH%;C:\Program Files\JetBrains\PyCharm\bin"

要在系统范围内为所有用户更新它,请运行 setx /M ,而不是 setx

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

pycharm64.exe

或者,您可以使用批处理脚本:

pycharm.bat

要从 Shell 运行 PyCharm,请使用带有以下选项的 open 命令:

-a

指定应用程序。

-n

即使已有一个实例在运行,也打开应用程序的新实例。

--args

指定要传递给应用程序的附加参数。

例如,您可以使用以下命令运行 PyCharm.app

open -na "PyCharm.app"

您可以在 PATH 环境变量所包含的目录中,使用此命令创建一个 Shell 脚本。 例如,创建文件 /usr/local/bin/pycharm ,内容如下:

#!/bin/sh open -na "PyCharm.app" --args "$@"

请确保您具有执行该脚本的权限,并且由于 /usr/local/bin 默认应位于 PATH 环境变量中,您应该能够在 Shell 的任意位置运行 pycharm

如果您没有权限执行脚本,请运行以下命令:

chmod +x /usr/local/bin/pycharm

在 Linux 上,安装目录下的 bin 中包含启动器 Shell 脚本 pycharm.sh 。 例如,如果您将 PyCharm 安装到 /opt/pycharm ,您可以使用以下命令运行该脚本:

/opt/pycharm/bin/pycharm.sh

您可以在 PATH 环境变量所包含的目录中创建一个指向启动器脚本的符号链接。 例如,如果您希望在 /usr/local/bin 中创建名为 pycharm 的链接,请运行以下命令:

ln -s /opt/pycharm/bin/pycharm.sh /usr/local/bin/pycharm

由于 /usr/local/bin 默认应位于 PATH 环境变量中,您应该能够在 Shell 的任意位置运行 pycharm 命令。

如果您 将 PyCharm 安装为 Snap 软件包 ,可以使用相应的启动器: pycharm-professionalpycharm-community

由 Toolbox 应用程序生成的 Shell 脚本

如果您使用 Toolbox 应用程序 安装并管理 JetBrains 产品,您可以使用 Shell 脚本从命令行启动 IDE。

Toolbox 应用程序会自动生成 Shell 脚本,并将其放置到以下文件夹中:

%LOCALAPPDATA%\JetBrains\Toolbox\scripts

默认情况下,Toolbox 应用程序会将 Shell 脚本放在系统 PATH 环境变量中的目录中,因此您可以将脚本的名称作为命令,从任意工作目录启动 PyCharm。

更改 Shell 脚本位置

  1. 打开 Toolbox 应用程序,点击右上角的 Toolbox 应用菜单 图标,并选择 设置

    Toolbox 应用程序菜单图标
  2. 设置 选项卡上,展开 工具 部分,并在 Shell 脚本位置 字段中指定另一个文件夹。

    更改 Shell 脚本的位置

重命名 Shell 脚本

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

  1. 打开 Toolbox App。

  2. 点击 IDE 实例旁边的 工具操作 ,然后选择 设置

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

Toolbox 应用程序 PyCharm 设置
/usr/local/bin

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

默认情况下,Toolbox 应用将 shell 脚本放在系统 PATH 环境变量中的某个目录中,因此您可以在任意工作目录中将脚本名称作为命令运行,以启动 PyCharm。

更改 Shell 脚本位置

  1. 打开 Toolbox App,点击右上角的 Toolbox 应用菜单 图标,然后选择 设置

    Toolbox 应用程序菜单图标
  2. 设置 选项卡上,展开 工具 部分,并在 Shell 脚本位置 字段中指定另一个文件夹。

    更改 Shell 脚本的位置

重命名 Shell 脚本

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

  1. 打开 Toolbox App。

  2. 点击 IDE 实例旁边的 工具操作 ,然后选择 设置

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

Toolbox 应用程序 PyCharm 设置
~/.local/share/JetBrains/Toolbox/scripts

默认情况下,Toolbox 应用将 shell 脚本放在系统 PATH 环境变量中的某个目录中,因此您可以在任意工作目录中将脚本名称作为命令运行,以启动 PyCharm。

更改 Shell 脚本位置

  1. 打开 Toolbox App,点击右上角的 Toolbox 应用菜单 图标,然后选择 设置

    Toolbox 应用程序菜单图标
  2. 设置 选项卡上,展开 工具 部分,并在 Shell 脚本位置 字段中指定另一个文件夹。

    更改 Shell 脚本的位置

重命名 Shell 脚本

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

  1. 打开 Toolbox App。

  2. 点击 IDE 实例旁边的 工具操作 ,然后选择 设置

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

Toolbox 应用程序 PyCharm 设置

命令行参数

启动脚本接受命令、选项和其他参数以修改其行为。 如果没有任何参数,脚本将启动 PyCharm。 如果您指定文件或目录的路径,PyCharm将会打开指定的文件或目录。 有关更多信息,请参阅 从命令行打开文件

命令

diff

打开差异查看器以查看两个指定文件之间的区别。

欲了解更多信息,请参阅 从命令行比较文件

merge

打开 合并 对话框以合并指定文件。

有关更多信息,请参阅 从命令行合并文件

format

将代码样式格式应用到指定文件。

有关更多信息,请参见 从命令行格式化文件

inspect

在指定项目上执行代码检查。

欲了解更多信息,请参阅 从命令行运行代码检查

选项

nosplash

加载 PyCharm 时不显示启动画面。

dontReopenProjects

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

disableNonBundledPlugins

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

--wait

等待文件关闭后再返回到命令提示符。

例如,您可以使用以下命令打开 file.txt

pycharm64.exe --wait file.txt

shell 将一直等待,直到 file.txt 关闭。

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