Cherrymelon’s Blog

Black的替代者？Ruff的使用教程

Tue, 16 Apr 2024 00:00:00 GMT

前言

Black是一个广泛流行的静态检查和格式化工具，也是常说的linter和 formtter，Ruff也是一款同样功能的工具，不同之处在于Ruff是Rust写的，Black是Python写的。这意味着Ruff相比Black，突出一个高性能，个人体验下来速度确实很快，1w行（谁懂啊）的python代码格式化速度大概做到了四分之一的Pycharm自带格式化性能开销。易用性也ok，兼容Black接近99%的历史代码，个人不太满意的一点就是格式化选项太少。

安装

很多方式都支持，一般用pip足够了

pip install ruff

配置ruff设置

在自己喜欢的位置创建pyproject.toml, ruff.toml, 或者.ruff.toml ，样例配置在官网上有,以下是我个人习惯的配置

上面有几行自定义的选项可以注意下

lint

select表示启用的检查规则，一般没有特殊需求可以不动，ignore 表示需要忽略的提示，比如有代码报E727了，你又不想一行行写noqa之类，就在这里加入E727

format

quote-style中double表示统一用双引号，这个单引号还是双引号看喜好和团队规范了。

skip-magic-trailing-comma true表示不根据你的尾随逗号来换行

配置precommit 钩子

安装precommit插件

pip install pre-commit

新建.precommit.yaml文件

一个典型的例子

安装git hook脚本

注意是在项目的根目录哦 pre-commit install

运行

两个常用命令 ruff check 和 ruff format，使用方式是类似的

Pycharm中的使用(可选)

market下一个插件，ruff，安装之后在设置-tools中找到ruff，可以按需求选择全局ruff还是按项目选择不同ruff。

注意，如果想用 ruff 替换掉 pycharm 的格式化功能的话，记得打开下图红框中的功能

Python 版本兼容踩坑记录

Tue, 29 Jul 2025 00:00:00 GMT

😀

记录一下pycharm使用远程调试模式时遇到的问题，花了一两个小时的功夫才弄清楚

昨天晚上在设置一个项目的远程解释器的时候，运行项目提示报错 ImportError: xxx/.venv/lib/python3.12/site-packages/_argon2_cffi_bindings/_ffi.abi3.so: invalid ELF header

服务器上环境为python3.12.2+cryptography45.0.5，cryptography加密库的版本基本上已经是最新的了，最初以为是项目 sync 到服务器的时候把本地 mac的二进制库 sync 到了 linux 服务器上，但是实际上通过 reinstall,卸载重新 build 等操作发现报错依旧，最后以为是版本兼容问题，通过 uv lock —upgrade 升级包依赖还是失败，于是继续尝试升级 python 到 3.12.11,最后成功启动

📎 参考文章

引用文章

UV-易用而快速的Python 包管理工具

Wed, 04 Sep 2024 00:00:00 GMT

uv 是一款基于 Rust 开发的 Python 包管理工具。

在尝试了 PDM 与 Poetry 这些复杂且不太友好的包管理工具后，终于迎来了一个类似 Cargo 的 Python 包管理工具。它文档清晰，风格与 Cargo 相似，能与 pip、pip-tools 无缝兼容。初次使用后感觉非常棒，目前在 GitHub 上已获得 19K 星标。

特性

基于 Rust 开发，比 pip快 10-100X，如果是之前看过我的 Ruff 使用之旅，从 Black切换到 Ruff 的同学应该深有体会，顺便一说，Ruff 也是他们团队开发的，利用 Rust 重构 Python 的生态链，看来是一个极其有价值的事情，Rust-Python截止到 24 年9 月，star 也干到 18K star，刚开始的时候 star 才 3k 不到

自带 Python 环境管理功能，类似 venv

提供类似 PDM，Poetry 的包版本管理和锁定功能

提供脚本单独配置运行的包版本，方便多版本使用

提供 cargo 风格的 workspace ，支持大型项目协同管理

支持 MacOS、Linux、Windows

安装

uv支持curl 或者pip 的方式安装，参照官网文档

安装完毕之后可以用 uv help 查看相关指令

使用

uv 使用一般有两种场景，从已有项目迁移和创建新项目。

新建新项目

cd到项目根目录下，uv init

会发现多了venv 、 pyproject.toml 和 uv.lock ,venv是项目的 python 虚拟环境，toml 是项目配置信息和依赖，uv.lock是用于版本控制的依赖文件。

从已有项目迁移

如果是从 potery、PDM管理的项目迁移过来的，利用其他工具翻译 toml 文件就行，如果是用 requirements管理的话，不推荐直接从文件添加，最好理清依赖关系再添加。

多人协作

从 git 上拉取已经用 uv 配置好的项目后，uv venv 创建虚拟环境，uv sync 安装依赖到本地。

当有新依赖发生修改时，uv lock 锁定依赖版本。

依赖管理

uv 的管理概念十分直观，uv add pkg 添加依赖，uv 会自动处理子依赖，uv remove pkg 移出依赖,添加的时候可以指定版本

下面截图就是我执行了 uv add utilmeta pymysql 之后的结构

安装并使用 python 包工具

有的人可能不太理解这一节内容是干嘛的，我举个例子，当你使用 ruff 格式化工具和 pre-commit钩子的时候，一般情况下是依赖某个 python 环境下安装的，而这个环境又可能与某个 project 绑定，当你切换到新项目工作时，难道还得重复安装一遍 ruff 或包含全路径的 ruff命令去执行？为了简单起见，可以使用uv tool 相关命令。

安装 ruff

uv tool install ruff

使用 ruff, uvx 等价于 uv tool run

uvx ruff check

查看包安装路径

uv tool dir

📎 参考文章

uv doc

uv github

2023年回顾

Sun, 07 Jan 2024 00:00:00 GMT

时间过得真快啊，一转眼一年就过去了，2023年春节回家接机的场景仿佛就在昨日，望向日历却发现2024年的春节已慢慢走近。大学室友接连在国庆和元旦拉开了人生中新的阶段，7年的爱情长跑终于修成正果，掐指一算，今年五一应是还有两个婚宴，一个发小玩伴的尽力而去，一个前任初恋的打死不去。根据周边观察，已婚的朋友们有娃的比例出乎意料的低，11对里面3对是有娃或者即将有娃的，还有一对结婚快6年了也还没打算要，只能说是窥见了时代的小小缩影。

国庆回了一趟家，发现母亲手上的老人斑已经悄悄浮现，一如当年姥姥的手。在家短短呆了3天的生活算是有滋有味，睡到自然醒，下楼溜达到曾经上学时过早的地方点上一碗熟悉的米线，味道还是原来的味道。

这一年见识了房地产开发商的“眼见他起高楼，眼见他宴宾客，眼见他楼塌了”，有人哭有人笑，头部房企重组，沪指下挫历史3000点，这应该是国内经济第一次遇到经济周期低谷，只能说，命运中一切的馈赠都标好了价格，开头简单的路到最后都是难走的。

说到读书，这一年书看的比较杂，什么林政毅的《猫咪家庭医学大百科》，作为一个养猫人，了解一下猫的常见疾病症状。草草浏览了一遍萨缪尔森的第19版《经济学》，读下来的体验不太好，边际效应，比较优势等都是平时了解过的东西，如果有精炼版面向只想看重点的人士更好。《鸟哥的私房菜第四版》这本书算是挺适合需要学习linux基础知识的人士，至少linux老手最多看下没见过的个别章节就行，因为里面磁盘的部分在机组书上已经见过，文件系统部分在操作系统书上也有。《Python源码剖析》，讲Python2.7解释器的源码，核心思路是与3.6往上区别不大，我只看了前四章，推荐有闲暇的人士看。《Fluent Python 第二版》，与第一版相比新增了3.6-3.10的特性，如typing，async await等，前面大半章节偏基础，后面异步，并发的部分可能实用性更强一点，元编程部分只读了前半部分，后面有遇到有需求的场景再翻书吧，捂脸。另外，b站有个up主，码农高天，做的Python视频挺不错。

在混乱的后新冠时代，希望大家照顾好自己，照顾好家人，2024年快乐

django migration 高级用法

Fri, 21 Jun 2024 00:00:00 GMT

最近对于 django 的 migration 迁移因为有不一般的需求，于是搜集了一下不常见的使用场景。

情景一

项目丢失 django migration历史记录，django 的 models 与数据库表结构不一致。

这种情况下，数据库的django migration表只能提供有限参考，如果从django migration表的最后一条记录开始手动重建migrate，需要挨个比较每个model与数据库表的差异，然后在空白migrate文件里写入对应的操作，最后执行 python manage.py migrate someapp 000X ，一般来说成功更新就说明续上了，后续开发直接走make migation → migrate的流程就行了

情景二

项目缺少 migration 文件，但是 models 与当前数据库一致。

这种情况需要从头开始重建migration文件，一般来说，可以考虑只生成两个文件，0001和0002，0001对应model现状，即一系列表的创建命令，0002作为当前你要增加的修改。对于每个app，首先对0001 执行 python manage.py migrate someapp 0001 —fake, 这代表更新model到0001的状态但是不实际执行，运行完这个命令后，你的数据库和model应该是一致的，相当于把历史的各个migrate记录压缩到了0001migration里

git stash 与 git worktree 切换分支方式

Thu, 16 Nov 2023 00:00:00 GMT

如果开发中遇到一个紧急修复需求，你会怎么做？

相信不少人看到这个问题下意识的会回答，使用 git stash 暂时存放当前的代码，然后基于最新的发版分支拉出一个 bugfix 分支进行开发。

有的会选择用 IDEA 全家桶的 shelve changes 功能，有的会选择用 commit 先保存当前工作代码。

这些方式都可以满足需求，但是 git stash 容易忘记 pop，git commit 不够优雅，IDEA 的 shelve changes 软件限定。

今天就介绍一下比较冷门的 git worktree，使用方式很简单。

首先基于你要拉取的分支创建一个新项目目录，git worktree add your_new_workdir your_need_pull_branch

假如我有一个go-hello项目，要基于dev创建 patch新分支就可以这样写

这样我们就在 go-hello项目的同级目录下创建了一个新的项目，然后就可以愉快的在新项目进行平行开发了。

当不用了之后，想要删除掉就输入

这样做优势在哪里？

主要有两个方面，一方面是git worktree add 只会复制真正发生改动的文件，未改动的文件指向的是原先的同一文件，对于大项目来说省下了不少磁盘空间。另一方面避免了在 git stash 后忘记切换或者代码有了冲突的情况