Scala 环境变量配置不生效，通常不是 Scala 本身的问题，而是变量作用域、加载顺序或工具链读取方式导致的。排查时先确认变量是否被当前 shell 和启动的进程看到，再检查构建工具或 IDE 是否覆盖了环境变量，最后核对 Scala 相关脚本（如 scala、scalac、sbt）实际读取的变量名和路径。
环境变量不生效优先排查三处：当前 shell 是否加载了配置文件、启动进程是否继承变量、工具链是否使用自己的配置覆盖环境变量。用echo $VAR和env | grep VAR确认变量存在，再用which scala和scala -version验证实际使用的 Scala 版本与路径。若变量在 IDE 或 sbt 中失效，检查启动脚本或配置文件是否显式覆盖。
先确认变量在当前 shell 中是否可见
打开终端后执行 echo $SCALA_HOME（或你设置的变量名），如果输出为空，说明变量没有被当前 shell 加载。常见原因是把 export 写在了 ~/.bashrc，但当前用的是 zsh 或非交互式 shell；或者修改后没有执行 source ~/.bashrc。用 env | grep -i scala 可以列出所有包含 scala 的环境变量，确认变量名拼写和值是否正确。
如果变量在交互式 shell 中存在，但在脚本或 IDE 中不存在，说明进程启动时没有继承该变量。例如从桌面图标启动的 IDE 可能不会读取 ~/.bashrc，需要检查 IDE 的启动配置或系统级环境变量设置。
检查 Scala 工具链实际读取的变量
Scala 的 scala 和 scalac 脚本通常依赖 JAVA_HOME 和 SCALA_HOME，但不同安装方式（如 coursier、sdkman、系统包管理器）可能使用不同的变量名或路径。执行 which scala 查看实际调用的脚本位置，打开该脚本检查它引用了哪些环境变量。例如，某些发行版的 scala 脚本会优先使用自身所在目录的相对路径，而不是 SCALA_HOME。
如果使用 sbt，sbt 启动脚本会读取 JAVA_HOME 和 SBT_OPTS，但不会自动使用 SCALA_HOME。sbt 项目中的 Scala 版本由 build.sbt 中的 scalaVersion 决定，与环境变量无关。若你期望通过环境变量切换 Scala 版本，需要确认工具是否支持该行为。
排查 IDE 和构建工具的覆盖行为
IntelliJ IDEA 等 IDE 可能在项目配置中指定了 JDK 和 Scala SDK，这些配置优先于系统环境变量。检查 File | Project Structure | SDKs 和 Global Libraries，确认 Scala SDK 路径是否指向你期望的版本。如果 IDE 从终端启动，可能继承终端的环境变量；从桌面启动则可能不继承，需要在 IDE 的启动脚本或系统环境变量中设置。
对于 Maven 或 Gradle 项目，构建工具可能通过 pom.xml 或 build.gradle 指定 Scala 版本，环境变量不会影响构建结果。此时应检查构建配置文件，而不是环境变量。
验证与常见陷阱
完成上述检查后，用以下命令验证：
echo $SCALA_HOME
echo $JAVA_HOME
which scala
scala -version
env | grep -i scala常见陷阱包括：变量值包含多余空格或引号；路径中使用 ~ 但未展开；在 /etc/environment 中设置变量但未重新登录；使用 sudo 时环境变量被重置。逐一排除后，通常能定位到具体环节。
常见问题
为什么在终端中能运行 scala，但在 IDE 中提示找不到？
IDE 可能没有继承终端的环境变量，或者 IDE 项目配置中指定的 Scala SDK 路径无效。检查 IDE 的 Scala SDK 设置，并确保 IDE 启动时能读取到 SCALA_HOME 或 PATH。
设置了 SCALA_HOME 但 scala 命令仍使用旧版本？
可能是 PATH 中旧版本路径优先，或者 scala 脚本内部硬编码了路径。用 which scala 确认实际调用的脚本，检查脚本内容及 PATH 顺序。