IntelliJ IDEA中特定Kotlin文件crate.kt语法高亮与分析缓慢问题排查

问题描述 #

编辑crate.kt时，语法高亮和代码分析速度极慢，哪怕是高亮WeightedChance.COMMON、BRONZE_BOLTS这类简单元素都远慢于正常水平；若文件包含长列表，IDEA甚至永远无法完成分析。
该问题在多台电脑、不同IDEA环境下均存在，且仅针对此文件，其他Kotlin文件运行完全正常。已尝试更新IDEA、调整高亮设置、清理缓存、检查插件兼容性，均未解决问题。

代码片段 #

package com.sakra.rs2.content.survival.loot.impl

import com.sakra.core.util.chance.Chance
import com.sakra.core.util.chance.WeightedChance
import com.sakra.rs2.content.survival.Constants
import com.sakra.rs2.content.survival.loot.Loot
import com.sakra.rs2.content.survival.loot.LootItem

class Crate : Loot {
override fun name() = "Crate"
override fun objectId() = 63
override fun emptyObjectId() = 354
override fun respawnInTicks() = 10
override fun rolls() = 2
override fun items() = Chance(
    listOf(
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_PLATEBODY)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_PLATELEGS)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_SWORD)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_SCIMITAR)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_DAGGER)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_BATTLEAXE)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_MACE)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_LONGSWORD)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_LONGSWORD)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_CROSSBOW)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_DART,1,100)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_KNIFE,1,100)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_THROWNAXE,1,100)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_ARROW,1,100)),
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_BOLTS,1,100)),

)
)
}

排查与解决步骤 #

1. 重构代码结构，简化长列表初始化 #

IDEA的Kotlin分析器对超大内联列表+嵌套构造调用的组合敏感度极高，可通过以下方式优化：

• 把items()内的列表抽成单独的类成员变量，减少内联嵌套层级：

class Crate : Loot {
    // ... 其他方法保持不变

    private val lootItems = listOf(
        WeightedChance(WeightedChance.COMMON, LootItem(Constants.Items.BRONZE_PLATEBODY)),
        // ... 所有物品项
    )

    override fun items() = Chance(lootItems)
}

• 封装重复逻辑减少代码冗余，比如重复的WeightedChance.COMMON：

private fun commonLoot(item: Constants.Items, min: Int = 1, max: Int = 1) = 
    WeightedChance(WeightedChance.COMMON, LootItem(item, min, max))

// 列表内直接调用：
private val lootItems = listOf(
    commonLoot(Constants.Items.BRONZE_PLATEBODY),
    commonLoot(Constants.Items.BRONZE_DART, 1, 100),
    // ...
)

2. 检查Constants.Items的复杂度 #

如果Constants.Items是包含大量枚举值的类，或内部有复杂初始化逻辑、扩展函数，IDEA解析每个Constants.Items.XXX时会重复计算导致卡顿：

• 若Constants.Items是object类，给常量添加const val标记
• 把常用物品常量提取到局部变量，减少对复杂类的重复访问

3. 临时禁用该文件的部分分析 #

若重构后仍卡顿，可临时降低该文件的分析强度：

• 右键文件 -> Mark as Plain Text，临时禁用语法高亮和分析（编辑时再改回）
• 在Settings > Editor > Inspections中，针对该文件排除特定Kotlin检查项

4. 强制重新索引文件 #

索引损坏可能导致单个文件异常：

• 打开File > Invalidate Caches...，选择Invalidate and Restart
• 重启后右键该文件 -> Synchronize 'crate.kt'

5. 对齐Kotlin版本 #

确保项目Kotlin版本与IDEA内置Kotlin插件版本完全一致：

• 查看build.gradle/build.gradle.kts中的kotlin_version
• 对比Settings > Languages & Frameworks > Kotlin的插件版本，不一致则更新其中一方

6. 修复隐性语法问题 #

检查文件是否存在隐性语法异常，比如代码片段末尾多余的尾逗号（Kotlin虽允许，但大量尾逗号可能触发分析器性能问题），建议删除多余逗号。

内容的提问来源于stack exchange，提问作者Joey Felling