IntelliJ中执行SBT命令报"not found: value ideaPort"错误求助

问题场景 #

在Ubuntu 22.04系统上使用IntelliJ自带的捆绑SBT（1.2.8版本）运行SBT Shell或命令时，触发以下错误：

<set>:1: error: not found: value ideaPort
ideaPort in Global := 34497
^
[error] Type error in expression

禁用Bytecode Indices后，又出现新报错：

[error] Not a valid command: idea-shell (similar: shell, oldshell)
[error] Not a valid project ID: idea-shell
[error] Expected ':'
[error] Not a valid key: idea-shell (similar: daemonShell)
[error] idea-shell
[error]           ^

终端运行SBT一切正常，但IntelliJ内无法使用相关功能。已尝试删除项目target、.idea目录、重装IntelliJ、切换自定义SBT版本等操作均无效，升级SBT到1.3.13后仍存在其他问题。

解决方法 #

1. 匹配Scala插件与SBT版本兼容性 #

旧版SBT（如1.2.8）和新版IntelliJ的Scala插件易出现兼容性冲突：

• 打开IntelliJ的Settings/Preferences -> Plugins，找到Scala插件查看版本。
• 降级Scala插件到与SBT 1.2.8适配的版本（例如IntelliJ 2021.x对应的Scala插件版本），避免使用最新插件。

2. 手动添加SBT IDEA插件依赖 #

ideaPort和idea-shell是IntelliJ与SBT通信的专用标识，项目缺少对应插件依赖会导致识别失败。在项目的project/plugins.sbt文件中添加：

addSbtPlugin("com.intellij" % "sbt-idea" % "1.6.0")

添加后刷新SBT项目，再尝试运行SBT Shell。

3. 重置IntelliJ与SBT的全局缓存 #

全局配置缓存损坏可能导致参数传递异常：

• 关闭IntelliJ，执行命令删除SBT全局缓存：

  rm -rf ~/.sbt/1.0/plugins/target
  rm -rf ~/.sbt/1.0/global.sbt
  

• 删除IntelliJ的SBT缓存目录（替换<版本号>为你的IntelliJ版本）：

  rm -rf ~/.cache/JetBrains/IntelliJIdea<版本号>/sbt
  

• 重启IntelliJ并重新导入项目。

4. 配置SBT使用原生Shell模式 #

确保IntelliJ使用SBT原生shell，且未添加无效参数：

• 打开Settings/Preferences -> Build, Execution, Deployment -> Build Tools -> sbt
• 在Build标签下勾选Use sbt shell for build and import
• 清空VM parameters输入框中的内容（若存在自动生成的ideaPort相关配置）

5. 检查系统环境变量干扰 #

系统环境变量可能影响IntelliJ与SBT的通信：

• 在终端执行echo $SBT_OPTS和echo $IDEA_PORT，若有输出则临时清空：

  unset SBT_OPTS
  unset IDEA_PORT
  

• 重启IntelliJ后重试。

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