Sublime Text如何使用Black格式化Python代码？官方规范一键排版-sublime-PHP中文网

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

sublime text如何使用black格式化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 会直接崩溃退出。

打开 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"