CANN/shmem Pre-commit使用指南

Pre-commit 代码检查使用指南

【免费下载链接】shmemCANN SHMEM 是面向昇腾平台的多机多卡内存通信库，基于OpenSHMEM 标准协议，实现跨设备的高效内存访问与数据同步。项目地址: https://gitcode.com/cann/shmem

介绍

本项目使用 pre-commit 框架在代码提交前自动执行代码质量检查，确保代码风格一致、无常见错误。

安装

1. 安装 pre-commit

pip install pre-commit

2. 安装 git hooks（推荐）

pre-commit install

安装后，每次git commit会自动运行检查。

使用方式

自动检查（推荐）

安装 git hooks 后，每次提交代码会自动触发检查：

git add . git commit -m "your message"

如果检查失败，部分工具会自动修复（如 ruff-format、clang-format），修复后重新提交即可。

手动检查

检查暂存的文件：

pre-commit run

检查指定文件：

pre-commit run ruff-check --files path/to/file.py pre-commit run clang-format --files path/to/file.cpp

检查单个 hook：

pre-commit run ruff-check pre-commit run pylint pre-commit run clang-format

跳过检查（不推荐）

git commit --no-verify -m "your message"

检查工具说明

配置文件说明

主配置文件

.pre-commit-config.yaml- 定义要运行的检查工具和参数

Python 工具配置

pre-commit/pyproject.toml- ruff、pylint、bandit 的规则配置

C++ 格式化配置

.clang-format- clang-format 的格式化规则

拼写检查白名单

pre-commit/typos.toml- typos 工具的误报白名单

常见问题

Q: 检查失败怎么办？

部分工具支持自动修复（如 ruff-format、clang-format），直接重新提交即可。对于需要手动修复的问题，根据错误提示修改代码后重新提交。

Q: 如何更新 pre-commit hooks？

pre-commit autoupdate

Q: 如何查看某个工具的详细错误信息？

pre-commit run pylint --verbose

Q: 如何临时禁用某条规则？

Python (ruff/pylint):在代码行尾添加注释

x = 1 # pylint: disable=invalid-name

C++ (clang-format):使用注释包围

// clang-format off int unformatted_code = 1; // clang-format on

Q: 首次运行很慢怎么办？

首次运行需要下载和安装各个检查工具的环境，之后会使用缓存，速度会快很多。

最佳实践

1. 安装 git hooks：使用pre-commit install自动检查每次提交
2. 不要频繁使用--no-verify：跳过检查可能导致问题代码进入仓库
3. 及时更新 hooks：定期运行pre-commit autoupdate获取最新版本
4. 配置 IDE 集成：在 IDE 中配置 ruff、clang-format 插件，实时检查

【免费下载链接】shmemCANN SHMEM 是面向昇腾平台的多机多卡内存通信库，基于OpenSHMEM 标准协议，实现跨设备的高效内存访问与数据同步。项目地址: https://gitcode.com/cann/shmem