Scala项目在VSCode中需安装Scala (Metals)和SBT Projects插件，确保sbt可用且版本匹配；调试需正确配置launch.json，注意provided依赖、Spark本地模式参数及UI端口冲突问题。
Scala项目在VSCode里根本跑不起来？先装对插件
VSCode原生不支持Scala，scala和sbt命令行能用 ≠ VSCode能识别或调试。必须装两个核心插件：Scala (Metals)（官方推荐）和SBT Projects（辅助构建）。别装Scala Syntax这类只改高亮的“假插件”，它们不提供运行/调试能力。
安装后重启VSCode，打开含build.sbt的根目录——Metals会自动下载并启动服务，状态栏右下角出现Metals: Ready才算真正就位。如果卡在Importing build，大概率是sbt版本和项目scalaVersion不匹配，去project/build.properties里核对sbt.version是否被项目要求锁死。
- Mac/Linux用户：确保
sbt在终端能执行，且which sbt路径被VSCode继承（避免从Launchpad点开VSCode导致PATH丢失） - Windows用户：禁用
Windows Subsystem for Linux (WSL)自动启用选项，否则Metals可能连错sbt环境 - 遇到
Failed to connect to build server：删掉./metals/和target/重试，不是重装插件
断点不生效？检查launch.json里的mainClass和classpath
VSCode调试Scala靠的是launch.json配置，但Spark项目尤其容易在这里翻车——它不是Java那种直接指定mainClass就能跑的简单逻辑。你得区分清楚：是调试纯Scala逻辑，还是带SparkContext的本地模式？
纯Scala调试示例（.vscode/launch.json）：
{
"configurations": [{
"type": "scala",
"request": "launch",
"name": "Run Main",
"mainClass": "com.example.MyApp",
"args": [],
"env": {}
}]
}
Spark本地模式调试关键点：
-
mainClass必须指向含def main(args: Array[String])的对象，不能是trait或class - 必须显式设置
spark.master为local[*]，否则启动时卡住无报错 - 若用
spark-submit脚本方式运行，VSCode断点完全无效——它只能调试JVM进程，不能attach到submit启动的子JVM
Spark调试时抛NoClassDefFoundError？别怪插件，查依赖范围
常见现象：断点进了main，但一调用spark.read.parquet(...)就崩，报java.lang.NoClassDefFoundError: org/apache/spark/sql/SparkSession。这不是类路径没加载，而是provided依赖在本地调试时被忽略。
Spark项目build.sbt里常这么写：
libraryDependencies ++= Seq( "org.apache.spark" %% "spark-sql" % "3.5.0" % "provided", "com.typesafe.slick" %% "slick" % "3.4.1" )
问题就出在% "provided"——Metals默认只加载compile和test范围的依赖，provided被跳过。解决方法只有两个：
- 临时改成
% "compile"再调试（上线前务必改回去） - 在
launch.json里加"jvmOptions": ["-Dspark.master=local[*]"]并确认spark-sqljar确实在target/scala-*/classes/同级的lib/目录下（Metals不会自动把provided依赖打进lib）
调试Spark UI打不开？端口冲突比你想象中更常见
设了spark.ui.port=4040，浏览器却显示Connection refused，十有八九是端口被占。Spark默认会顺延尝试4041、4042……但VSCode调试器启动快，经常抢在Spark自动端口探测前就卡死了。
实操建议：
- 启动前先执行
lsof -i :4040（Mac/Linux）或netstat -ano | findstr :4040（Win），杀掉占用进程 - 在
launch.json的env里强制指定唯一端口："SPARK_LOCAL_IP": "127.0.0.1", "SPARK_UI_PORT": "4045" - 别信
spark.ui.enabled=true——它只是开关UI服务，不解决端口绑定失败的问题
复杂点在于：Spark UI依赖Jetty，而某些公司防火墙策略会拦截非80/443端口的本地HTTP响应，这时候即使端口空闲，浏览器也打不开。最稳的办法是用curl http://127.0.0.1:4045/json先确认API通不通，再决定是不是该换网络环境。
