如何在PyCharm中对当前激活文件运行pre-commit钩子（无需提交）

步骤1：确保pre-commit环境就绪 #

如果还没安装pre-commit，先通过命令行完成安装：

pip install pre-commit

确保你的项目根目录存在.pre-commit-config.yaml配置文件，且已执行过pre-commit install（若未执行，在项目根目录运行该命令即可）。

步骤2：配置PyCharm外部工具 #

1. 打开PyCharm设置（快捷键Ctrl+Alt+S，或通过File → Settings路径进入）
2. 找到Tools → External Tools，点击右上角+号新建工具
3. 填写以下配置项：
   • Name: 自定义名称，比如Run pre-commit on Current File
   • Program: 输入pre-commit（若它在系统PATH中），或具体可执行文件路径（例如Linux/macOS的~/.local/bin/pre-commit，Windows的%USERPROFILE%\AppData\Roaming\Python\Scripts\pre-commit.exe）
   • Arguments: run --files $FilePath$
   • Working directory: $ProjectFileDir$
   • 可选勾选Synchronize files after execution，确保钩子修复后的文件能实时同步到PyCharm

步骤3：设置快捷键 #

1. 在设置界面导航到Keymap
2. 在搜索框输入刚才新建的工具名称，定位到对应条目
3. 右键点击该条目，选择Add Keyboard Shortcut
4. 按下你习惯的快捷键组合（比如Ctrl+Shift+C，注意避开已有快捷键冲突），点击OK保存

使用方式 #

打开需要处理的文件并确保它是当前激活标签页，按下设置好的快捷键，pre-commit就会自动对该文件运行所有配置的钩子。如果钩子支持自动修复（如black、isort），修改会直接应用到文件中，全程无需提交操作。

内容的提问来源于stack exchange，提问作者emilaz