Sublime Text中集成Ruff加速Python静态分析与代码格式化-sublime-PHP中文网

sublime text 需通过 lsp 插件与 ruff-lsp 协同实现 python 静态分析和保存即格式化，关键在于正确安装 ruff-lsp、显式配置路径、项目根目录含 pyproject.toml、启用 format = true 并开启 lsp 的 format_on_save，调试需依赖日志而非重装。

sublime text中集成ruff加速python静态分析与代码格式化

Sublime Text 本身不内置 Python 静态分析或格式化能力，但通过 ruff-lsp 可以实现实时 linting 和保存即修复——前提是正确配置 LSP 插件与 Ruff 的协同关系，否则容易卡在“有提示没修复”或“格式化不生效”状态。

确认已安装 LSP 插件和 ruff-lsp

Sublime Text 必须先装好 LSP 插件（不是 LSP-json 或其他变体），再手动安装 ruff-lsp 服务。仅装 ruff CLI 不够，ruff-lsp 是独立的 Language Server 实现，不是 ruff 自带的子命令。

LSP 插件需从 Package Control 安装，启用后会在菜单栏出现 LSP 项
ruff-lsp 不能用 pip install ruff-lsp（不存在这个包），必须用 npm install -g ruff-lsp 或从 GitHub release 下载预编译二进制（推荐 macOS/Linux）
验证是否可用：ruff-lsp --version 应输出类似 0.7.x；若报 command not found，说明没加到 $PATH，Sublime Text 默认不读 shell 的 PATH，需在 LSP.sublime-settings 中显式指定 "command"

配置 LSP 识别 Python 项目并启用 ruff-lsp

Sublime Text 不会自动把当前文件夹当 Python 项目，ruff-lsp 需要明确知道它该在哪个目录下读 pyproject.toml 并加载规则。靠文件后缀 .py 不足以触发完整 linting。

在项目根目录确保存在 pyproject.toml，且至少包含 [tool.ruff] 节（哪怕为空）
打开 Sublime Text 后，用 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）调出命令面板，运行 LSP: Enable Language Server Globally → 选 ruff-lsp，这步决定全局启用
更稳妥的做法是：右键项目文件夹 → Open Folder as Project，然后在 Project → Edit Project 中添加以下字段，强制绑定 Python + ruff-lsp：

"settings": {
  "LSP": {
    "ruff-lsp": {
      "enabled": true,
      "settings": {
        "ruff": {
          "executable": "/usr/local/bin/ruff-lsp"
        }
      }
    }
  }
}

路径 /usr/local/bin/ruff-lsp 需替换成你实际安装的位置，可通过 which ruff-lsp 查看。

python-code-analyz

专业Python代码分析与优化，支持语法检查、安全扫描、性能评估、复杂度分析及重构后优化代码生成。

下载

保存时自动格式化失效的常见原因

Sublime Text 的“保存即格式化”依赖两个条件同时满足：LSP 正确响应 textDocument/formatting 请求，且编辑器配置允许在保存时触发。缺一不可。

检查 LSP.sublime-settings 是否含 "auto_complete": true 和 "format_on_save": true（注意这是 LSP 插件的设置，不是 Sublime 原生设置）
ruff-lsp 默认不启用格式化功能，必须在 pyproject.toml 中显式开启：[tool.ruff] 下加 format = true，否则 ruff-lsp 收到格式化请求也会返回空响应
如果用了 select = ["E", "F"] 但漏了 "I"（import 相关规则），ruff-lsp 可能跳过 import 排序——这不是 bug，是规则控制逻辑，isort 功能已被整合进 ruff，但受 select 控制
Windows 用户常遇到路径分隔符问题：ruff-lsp 在 Windows 上对 pyproject.toml 中的 exclude 路径（如 "tests\"）敏感，建议统一用正斜杠 "tests/"

调试 ruff-lsp 无反应的最快方式

当编辑器里看不到任何波浪线或保存后毫无变化，不要猜，直接看日志。LSP 插件的日志开关藏得深，但它是唯一能暴露连接失败、配置未加载、规则被忽略等真实原因的出口。

打开 Tools → Developer → Show Console，输入：sublime.log_commands(True)，再触发一次保存操作，观察控制台是否有 LSP 相关 error
更关键的是打开 LSP 日志：Preferences → Package Settings → LSP → Settings，在右侧用户设置中加："log_stderr": true, "log_server": true，重启 Sublime，错误会输出到 Console 里
典型报错如 Failed to start server: ruff-lsp not found 表明路径不对；Config not loaded for /path/to/file.py 表明没识别到项目根或 pyproject.toml 格式错
别依赖 ruff check --fix 命令行结果来判断 LSP 行为——CLI 和 LSP 使用同一套配置，但加载时机、缓存策略、工作目录都不同，CLI 成功 ≠ LSP 正常