Shift+Alt+F 格式化 Scala 文件没反应，是因为 Metals 未正确配置为默认格式化器：需安装 scalameta.metals 插件，并在 .vscode/settings.json 中设置 "[scala]": { "editor.defaultFormatter": "scalameta.metals" }。
Shift+Alt+F 格式化 Scala 文件没反应？先确认 Metals 是否接管
VSCode 默认对 .scala 文件完全不格式化，Shift+Alt+F 静默失败是常态，不是你按错了。根本原因是缺少语言专属格式化器路由配置。
必须确保两点同时成立：
- 已安装
scalameta.metals插件（不是 “Scala (sbt)” 等废弃插件） -
.vscode/settings.json中存在"[scala]": { "editor.defaultFormatter": "scalameta.metals" }这一节
缺任何一项，Shift+Alt+F 都只会做基础缩进对齐，不会处理 case class 字段垂直排列、for 推导式换行、match 分支缩进等函数式排版需求。
Ctrl+K Ctrl+F 选中代码块格式化，但需注意作用域边界
函数式代码常含嵌套表达式（如 map(_.toString).filter(_.nonEmpty).flatMap(...)），直接全选再 Ctrl+K Ctrl+F 容易把不该换行的地方强行折行，或忽略内部结构。
更稳妥的做法是：
- 将光标停在某层括号内（如
map调用的括号里），再触发Ctrl+K Ctrl+F—— Metals 会基于 AST 只格式化该子表达式 - 对
match块，选中整个match { ... }再格式化，否则分支可能错位 - 避免跨多行手动选中后格式化；函数式链式调用建议用
Shift+Alt+F全文件处理，让 scalafmt 规则统一生效
F12 / Alt+F12 查看定义时，函数式语法支持依赖 Metals 启动状态
点击 map、flatMap、given 或 using 关键字跳转定义，常出现“无法定位定义”——这不是快捷键失效，而是 Metals 未完成语义索引。
典型表现和应对：
- 右下角状态栏显示 “Compiling…” 或 “Indexing…”：等待完成再试，强行跳转会失败
- 刚打开项目就按
F12：先保存任意.scala文件触发编译，或手动执行命令面板中的Metals: Restart Build Server - 跳转到
def或val正常，但跳不到given实例：检查项目是否为 Scala 3，且build.sbt中启用了scalaVersion := "3.3.3"类版本
Ctrl+Shift+L 选中所有同名符号，慎用于高阶函数参数
在 list.map(x => x * 2) 中把光标放在 x 上按 Ctrl+Shift+L，会同时选中所有 x 参数 —— 看似方便，但极易误改闭包内变量名，破坏函数纯度。
真实场景中应更谨慎：
- 仅在明确知道该符号无重名歧义时使用（如顶层
val config = ...） - 对 lambda 参数，优先用
F2重命名：它会校验作用域，只改当前 lambda 内的绑定，不污染其他闭包 - 遇到
_占位符（如list.filter(_ > 0)），Ctrl+Shift+L无效 —— Metals 不将其视为可重命名符号
函数式代码的变量名短而密集，光标位置稍偏一点就可能选错作用域，这是最常被忽略的细节。
