デッドコード消せてますか？構文解析とGradleプラグイン開発で始めるコードベース改善

デッドコードはコードの保守性を低下させる要因の一つですが、新規開発が優先されることが多く、結果としてコードベースの健全性が損なわれることがあります。
私たちのプロダクトでは、開発生産性向上のためにフィーチャーフラグを活用しています。
しかし、リリース後に不要となったフィーチャーフラグがデッドコードとして残る問題に直面しました。
この問題を解決するために、kotlin-compiler-embeddableを用いた構文解析とGradleプラグイン開発によるデッドコード削除の自動化を試みました。

このセッションでは、それぞれの実装方法について言及しつつ、フィーチャーフラグに起因するデッドコードの削除を自動化した経験を共有します。
これらのテクニックはデッドコード削除以外にも応用可能であり、セッション参加者の皆様のアイデア実現の一助となれば幸いです。

Transcript

2. デッドコード消せてますか？ 構文解析と Gradleプラグイン開発で始める コードベース改善 2025/11/01 Kotlin Fest 2025 Task
3. Task (Tasuku Nakagawa) 株式会社マネーフォワード 大阪開発拠点 バックエンドエンジニア 兼EM見習い X (Old Twitter): getupmax GitHub: T45K
4. デッドコード
5. fun hoge(): String { return "hoge" // Cannot reach here! throw RuntimeException("fuge") }
6. 絶対に到達し得ないコード
7. 放置すると • コードベースの肥大化 • 誤ったコード理解の誘発 • etc.
8. 消しましょう
9. これは？
10. fun main() { val isReleased = isFeatureReleased("CALC_FEE") if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 fun oldCalcFee(value: Int) = value * 0.9
11. フィーチャーフラグ
12. フィーチャーフラグ • システムの動作を動的に変更する仕組み • 単純な if-else 文によって実装できる • トランクベース開発には必須 https://martinfowler.com/articles/feature-toggles.html
13. fun main() { val isReleased = isFeatureReleased("CALC_FEE") if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 fun oldCalcFee(value: Int) = value * 0.9
14. リリース後はデッドコード
15. 消しましょう
16. できる？
17. スケジュール ビ ジ ネ ス 要 求 デグレ 費 用 対 効 果 修正箇所の特定
18. 削除を自動化したい！
19. fun main() { val isReleased = isFeatureReleased("CALC_FEE") if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 fun oldCalcFee(value: Int) = value * 0.9
20. fun main() { calcFee(100) } fun calcFee(value: Int) = value * 0.95
21. どうやって削除対象の コードを特定するか
22. fun main() { val isReleased = isFeatureReleased("CALC_FEE") if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 fun oldCalcFee(value: Int) = value * 0.9
23. fun main() { val isReleased = isFeatureReleased("CALC_FEE") if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 fun oldCalcFee(value: Int) = value * 0.9
24. fun main() { val isReleased = isFeatureReleased("CALC_FEE") if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 fun oldCalcFee(value: Int) = value * 0.9
25. 完全な自動化は難しそう
26. 実装時に明示的に指定する
27. - 事故を防ぐ - コードを書くときに 消されることを意識できる
28. fun main() { val isReleased = isFeatureReleased("CALC_FEE") if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 fun oldCalcFee(value: Int) = value * 0.9
29. fun main() { @Remove val isReleased = isFeatureReleased("CALC_FEE") @RemoveElse if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 @Remove fun oldCalcFee(value: Int) = value * 0.9
30. アノテーションがついている コードを特定したい
31. 構文解析
32. 構文解析 • ソースコードを構造化された形式へ変換する • （抽象）構文木という木構造に変換される • コンパイルの過程で実行される
33. if (isReleased) { calcFee(100) } else { oldCalcFee(100) } If statement Condition Then clause Else clause Expression isReleased Expression Function call calcFee args: 100 Function call oldCalcFee args: 100 Expression
34. Kotlinコンパイラを ライブラリとして使いたい
35. Kotlin Compiler Embeddable
36. plugins { kotlin("jvm") version "2.2.1" } dependencies { implementation( mapOf( "group" to "org.jetbrains.kotlin", "name" to "kotlin-compiler-embeddable", ) ) }
37. fun main() { // 構文解析用のファクトリを作る val disposable = Disposer.newDisposable() val environment = KotlinCoreEnvironment.createForProduction( disposable, CompilerConfiguration(), EnvironmentConfigFiles.JVM_CONFIG_FILES ) val project = environment.project val factory = KtPsiFactory(project) val kotlinFilePath = Path("/path/to/kotlin/file") // 構文解析を行う val ktFile = factory.createFile(kotlinFilePath.readText()) }
38. open class KtFile(…) : … { … override fun <R, D> accept( visitor: KtVisitor<R, D>, data: D ): R { return visitor.visitKtFile(this, data) } … }
39. Visitorパターン
40. Visitorパターン • オブジェクト構造と、それに対する操作を 切り離すデザインパターン • 構文木がオブジェクト構造、 対象のコードの特定と保存が操作
41. class RemoveTargetVisitor : KtTreeVisitorVoid() { val elements: MutableList<KtElement> = mutableListOf() override fun visitNamedFunction(function: KtNamedFunction) { if (element.isAnnotated()) { elements.add(function) } else { return super.visitNamedFunction(function) } } } private fun KtAnnotated.isAnnotated(): Boolean = …
42. fun calcFee(value: Int) = value * 0.95 @Remove fun oldCalcFee(value: Int) = value * 0.9
43. fun calcFee(value: Int) = value * 0.95 @Remove fun oldCalcFee(value: Int) = value * 0.9 Root Function declaration calcFee value: Int Body Function declaration oldCalcFee value: Int Body Remove
44. Root Function declaration calcFee value: Int Body Function declaration oldCalcFee value: Int Body Remove Visitor elements = []
45. Root Function declaration calcFee value: Int Body Function declaration oldCalcFee value: Int Body Remove Visitor elements = []
46. Root Function declaration calcFee value: Int Body Function declaration oldCalcFee value: Int Body Remove Visitor elements = []
47. Root Function declaration calcFee value: Int Body Function declaration oldCalcFee value: Int Body Remove Visitor elements = []
48. Root Function declaration calcFee value: Int Body Function declaration oldCalcFee value: Int Body Remove Visitor elements = [oldCalcFee]
49. 集めたelementsを ソースコードから取り除く
50. val sourceCode: String = … … val elements = … elements.forEach { sourceCode.removeRange(it.startOffset, it.endOffset) }
51. fun main() { @Remove val isReleased = false @RemoveElse if (isReleased) { calcFee(100) } else { oldCalcFee(100) } } fun calcFee(value: Int) = value * 0.95 @Remove fun oldCalcFee(value: Int) = value * 0.9
52. fun main() { calcFee(100) } fun calcFee(value: Int) = value * 0.95
53. 第一部完
54. 課題
55. 実行環境
56. 元々テストコードとして 書いていた
57. class RemoveFeatureFlagTest { @Test @Disabled fun removeFeatureFlag() { val files = … files.forEach { file -> val elements = … // Remove elements from file } } }
58. • 可搬性が低い • シュッと実行できない （@Disabledをアンコメントして...）
59. Gradleプラグイン
60. Gradleプラグイン • Taskとして定義されたロジックを実行できる • コマンド一発で実行できる • 他のGradleプロジェクトでも使いまわせる https://docs.gradle.org/current/userguide/plugins.html
61. abstract class RemoveFeatureFlagTask : DefaultTask() { @get:Input abstract val input: Property<String> init { group = "group name" description = "description" } @TaskAction fun removeFeatureFlag() { … } }
62. class FeatureFlagRemoverPlugin : Plugin<Project> { override fun apply(project: Project) { project.tasks.register( "removeFeatureFlag", RemoveFeatureFlagTask::class.java ) } }
63. plugins { id("feature-flag-remover") version "1.0.0" }
64. class RemoveFeatureFlagTest { @Test fun removeFeatureFlag() { val files = … files.forEach { file -> val elements = … // Remove elements from file } } } ./gradlew test --tests RemoveFeatureFlagTest
65. ./gradlew removeFeatureFlag feature_name
66. 第二部完
67. • 他のプロジェクトに適用したり • 非バックエンドメンバーでも 作業できるようになったり • AI Agentのワークフローに 組み込んだり
68. 俺たちの旅はまだまだこれからだ... • Kotlin Compiler Embeddingのセットアップが Deprecatedになってた • Gradle Pluginのテスト方法は色々試したい • どちらの技術も完全に理解できてない
69. まとめ
70. フィーチャーフラグによる デッドコードの除去を 自動化した - 構文解析で特定 - Gradleプラグインで実行
71. いろんな用途で使えそう - 他のリファクタリングを 自動化したり - Linterを実装したり
72. 皆様のアイデアを実現する 一助になれば！