Sublime Text中Black插件不生效的根本原因是black可执行文件路径未正确配置或未在目标Python环境安装；需在Package Settings中指定虚拟环境内的绝对路径，重启后生效，并确保语法识别为source.python。

Sublime Text 本身不支持 Black 格式化，装完插件不生效是常态，根本原因几乎总是 black 可执行文件路径没填对、或根本没装 black 命令。

为什么 Ctrl+Shift+P 找不到 Black: Format？

不是插件没装，而是 Sublime 没法自动发现 black——它只认你手动指定的绝对路径。

• 先在终端运行 black --version，如果报 command not found，说明系统里压根没装 black，得先 pip install black
• 若用虚拟环境（比如 venv 或 conda），必须在该环境下装：venv/bin/pip install black（macOS/Linux）或 venvScriptspip.exe install black（Windows）
• 打开 Preferences → Package Settings → Black → Settings，填入完整路径："black_executable": "/path/to/venv/bin/black"（不能写 black，不能写 ./venv/bin/black）
• 路径中不能含空格或中文；Windows 上要带 .exe 或 .cmd 后缀，例如 C:\Users\name\venv\Scripts\black.exe
• 改完设置必须重启 Sublime Text，否则新配置不加载

Ctrl+Alt+F 格式化 Python 文件却报错 code 123？

这是 black 主动拒绝格式化的信号，和插件无关，说明代码本身有硬性问题。

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

• 检查第一行是否为合法 shebang，比如 #!/usr/bin/env python3；若用记事本保存过，可能混入 BOM，black 直接拒处理
• 确认文件编码是 UTF-8 无 BOM；在 Sublime 中右键 → Reopen with Encoding → UTF-8
• 运行 black --check your_file.py 看终端具体报错，比插件日志更准——常见于未闭合括号、f-string 中未转义的 {、或缺失 # -*- coding: utf-8 -*- 声明
• 如果用了 pyproject.toml 配置 line-length 等参数，确保该文件在当前文件所在目录或其任意上级目录中，且 Sublime 有读取权限

如何让 Ctrl+Alt+F 只在 .py 文件生效，不误触其他类型？

快捷键必须按作用域（scope）绑定，否则在 JS 文件里按 Ctrl+Alt+F，black 会直接崩溃退出。

立即学习“Python免费学习笔记（深入）”；

• 打开 Preferences → Key Bindings，在右侧用户配置中添加：

• [
    {
      "keys": ["ctrl+alt+f"],
      "command": "black",
      "context": [
        { "key": "selector", "operator": "equal", "operand": "source.python" }
      ]
    }
  ]

• source.python 是 Sublime 内部语法作用域名，不是文件后缀；右下角显示 Python 才有效，显示 Plain Text 或 Python 3（旧插件遗留）都不行
• 若想同时支持 .pyi 文件，把 operand 改成 "source.python, source.pythoni"

最常被忽略的一点：Sublime 的语法识别和插件作用域是两套独立机制。哪怕你装了最新版 black、路径也绝对正确，只要右下角显示的是 Plain Text，所有格式化命令都会静默失效——它连触发机会都不给。