2024/11/09 LT 言語化できない人が可読性について考えてみた話

Transcript

1. 言語化できない人が可読性について 考えてみた話 MoneyForward pay事業本部 Tae.hyunseok(ソク)
2. 1. 背景 2. SonarQubeとは 3. Cognitive Complexity 4. 変数名について はじめ
3. -　自分の言葉を言語化し話すのが難しい ..　 　 -　言語の構造化 　 -　SonarQubeの導入 　 -　SonarQubeから指摘されているコードがまるで私だった。 背景
4. -　コードを分析し、品質を上げてくれる Tool とは?
5. 循環的複雑度 認知的複雑度 🎯 定義： コードの分岐パスの数を測定 🧠 定義： コードの理解のしやすさを測定 📊 計算方法： • if文: +1 • for/while文: +1 • case文: +1 • &&/||: +1 📈 計算方法： • 基本構造: +1 • ネスト1階層: +2 • ネスト2階層: +3 • else文: +1 ❌ 限界： • ネストの深さを考慮しない • コードの可読性を反映しない • 単純な数値的評価 ✅ 利点： • ネストの影響を考慮 • 人間の理解度を反映 • より実践的な評価 Cognitive complexity Code Smell(Critical)Cognitive Complexity of functions should not be too high
6. 同じ循環的複雑度のコードでも差がある ❗ネストが深い実装 認知的複雑度 : 6 📊 循環的複雑度 : 4 ⭐シンプルな実装 認知的複雑度 : 4 📊 循環的複雑度 : 4
7. 🍺変数名で自分が意図する情報を含む 🍺
8. 変数名は具体的に書くほど良いか 🤔
9. ありがとうございました。 最後に