docs/zh_CN/api-guides/tools/idf-clang-tidy.rst
IDF clang-tidy
:link_to_translation:en:[English]
IDF clang-tidy 是使用 clang-tidy <https://clang.llvm.org/extra/clang-tidy/>__ 对当前应用程序进行静态分析的工具。
.. warning::
IDF clang-tidy 的功能及其依赖的工具链尚在开发中，最终版本发布前可能有重大变更。
目前仅支持基于 clang 的工具链。在配置项目前，必须在环境变量或 CMake 缓存中设置 IDF_TOOLCHAIN=clang 进行激活。
初次运行此工具时，请按照以下步骤准备该工具：
#. 运行 idf_tools.py install esp-clang 安装 clang-tidy 所需的二进制文件。
.. note::
该工具链尚在开发中，最终版本发布后，将无需手动安装工具链。
#. 再次运行导出脚本（如 export.sh、export.bat 等），刷新环境变量。
clang-check运行 idf.py clang-check 可以重新生成编译数据库，并在当前项目文件夹下运行 clang-tidy，所得输出写入 <project_dir>/warnings.txt。
运行 idf.py clang-check --help 查看完整文档。
clang-html-report#. 运行 pip install codereport 安装附加依赖关系。
#. 运行 idf.py clang-html-report 会根据 warnings.txt 在 <project_dir>/html_report 文件夹内生成 HTML 报告。请在浏览器中打开 <project_dir>/html_report/index.html 查看报告。
此工具托管在 espressif/clang-tidy-runner <https://github.com/espressif/clang-tidy-runner>。如遇到任何错误，或有任何功能请求，请通过 Github issues <https://github.com/espressif/clang-tidy-runner/issues> 提交报告。