Sublime配置Pre-commit钩子_在代码提交前自动执行Lint与测试

Sublime Text 通过 pre-commit 框架在 Git 提交前自动执行 lint、格式化和测试；需安装 pre-commit 并配置 .pre-commit-config.yaml，配合 SublimeLinter 和 Black Formatter 实现保存即校验，注意编辑器与钩子配置一致。

Sublime Text 本身不直接支持 Git 的 pre-commit 钩子，但你可以通过外部工具链，在代码提交前自动触发 lint 和测试——关键在于把校验逻辑“前置”到 Git 提交流程中，而不是依赖编辑器内置功能。Sublime 只需配合好保存行为和终端命令，就能实现无缝体验。

用 pre-commit 框架统一管理钩子

推荐使用 pre-commit（Python 工具），它轻量、跨平台、配置清晰，且能复用社区大量现成检查器（如 black、flake8、eslint、jest 等）。

• 安装：pip install pre-commit
• 项目根目录初始化：pre-commit install（会自动生成 .git/hooks/pre-commit）
• 配置 .pre-commit-config.yaml，例如：

repos:
- repo: https://github.com/psf/black
  rev: 24.4.2
  hooks:
    - id: black
- repo: https://github.com/pycqa/flake8
  rev: 6.1.0
  hooks:
    - id: flake8

每次 git commit 时，这些工具会自动运行在暂存区文件上，失败则中断提交。

让 Sublime 保存时自动格式化（可选增强）

虽然 pre-commit 是提交时兜底，但你可以在 Sublime 中提前看到格式/语法问题，提升效率：

• 安装插件 SublimeLinter + 对应 linter（如 SublimeLinter-flake8、SublimeLinter-eslint）
• 安装 Black Formatter 或 JsPrettier 实现保存即格式化
• 启用 "auto_format_on_save": true 等设置，让编辑器行为与 pre-commit 规则尽量一致（比如都用 black）

⚠️ 注意：编辑器格式化 ≠ pre-commit 校验。务必确保两者配置一致（如 black 版本、缩进、行宽），否则容易出现“本地能提交，CI 却失败”的情况。

标签： 代码提交 python sublime js git github 工具