这阵子琢磨着把手里几个小项目的代码给收拾一下,之前都是各自为政,代码风格啥的都没统一,看着就头大。想着干脆整一套标准得了,选来选去,决定试试 Ruff 这个工具,听说它速度快,而且配置起来应该挺省心的。
我这人写代码嘛追求的是个效率,真要花大工夫去研究复杂的配置,那还不如直接手改代码来得痛快。我一开始就盯着“简单几步搞定”这个目标去的。
上手第一步:装起来再说
最开始我干的就是安装。我通常是直接用 pip 扔进虚拟环境里的。敲下 pip install ruff,这个过程就跟装其他 Python 包一样,没啥特别的。几秒钟,搞定。这第一步感觉还挺顺畅的,没遇到权限问题或者版本冲突的幺蛾子。
配置文件的构建
光装上了没用,得让它知道我项目的规矩。我找了个没人管的项目文件夹,在项目根目录下起了个 文件。这文件我之前写过用其他工具,所以结构有点印象。

我开始往里填东西。最基础的结构就是这样:
- 先写个 头部,告诉 Ruff 这是它的配置区域。
- 接着就是定义我想跑哪些检查规则。一开始我没想搞太复杂,就想把那些常见的格式问题和潜在的 Bug 都抓出来。我直接抄了一份社区里常见的配置列表,把名字往
'lint'和'format'区域里堆。比如"E"(错误)、"F"(重构)、"I"(导入排序)这些基础的模块我全加上了。 - 然后就是排除一些我不想管的文件或者目录。我把
'venv'、'.git'这些给塞进了'exclude'列表里。
写这个配置文件的过程,比我预想的要直接。因为很多规则都有缩写,不用一个个去查全称,直接用代码字母代表就好了。这省了我不少时间去查文档。
实战检验:跑起来看看效果
配置完文件,我就想看看这玩意儿到底干了我切换到命令行,直接在项目根目录下了这个命令:ruff check .。我盯着屏幕看,Ruff 唰的一下就把文件扫完了,输出一堆红色的错误信息。
我挑了几个最明显的,比如 import 顺序乱了,还有一些不规范的变量命名,对照着错误提示去看。发现 Ruff 给的提示很到位,直接告诉你哪一行,错在哪里。

然后我开始动手改代码,对着提示改。改完一次,我再跑一遍 ruff check .,发现刚才那些报错的地方都消失了。这种即时反馈感真的很爽。
自动修复的魔力
光检查完让手改,效率还是有点低。我接着研究了自动修复功能。我又敲了一个命令:ruff check --fix .。我看着它开始动了,它不光报告问题,还直接把那些能自动修复的格式问题给改了。
我赶紧打开文件瞅瞅,发现那些多余的空格、错误的引用括号,甚至是一些可以简化的表达式,都被 Ruff 悄悄地给修正了。对于我这种代码写得多、容易偷懒的人来说,这简直是救星。
我把 扔进了版本控制,后续开发就强制所有人用这个标准了。几分钟的配置时间,换来的是后续维护的省心,这笔买卖我是赚大了。









