VSCode 无法提供 Elixir 并发与分布式能力，仅通过 erlang-ls 扩展支持可视化调试；必须手动配置 Erlang 分布式节点（-name、-setcookie、端口、主机解析），禁用 mix_task 调试模式，配合 Livebook 验证 Actor 行为。
VSCode 本身不提供高并发或分布式编程能力，Elixir 的并发模型（Actor 模型、轻量进程、消息传递）和分布式节点通信（:net_kernel、:rpc、Node.connect/1）完全由 Erlang/OTP 运行时实现。VSCode 只能通过正确配置语言服务器与调试器，让你「看清」和「控制」这些行为——而不是“开启”它们。
确认 Erlang 分布式基础已就位
Elixir 分布式能力依赖底层 Erlang 节点通信，VSCode 不参与节点启动，但若配置错误，调试器连不上、进程树为空、Node.list() 返回空列表都是常见现象。
- 终端中运行
erl -name test@127.0.0.1 -setcookie abc，确认能成功启动带名节点并接受连接 - 检查系统防火墙是否放行 EPMD 端口（默认 4369）和 Erlang 分布式端口段（默认 9000–9100）
- 确保所有参与节点使用相同
-setcookie值，且主机名可被彼此解析（ping test@127.0.0.1应通） - VSCode 中的
erlang.erlPath必须指向支持分布式编译的erl（Homebrew 安装的通常满足；自编译 OTP 需含+sname/+name支持）
启用 erlang-ls 的分布式调试视图
仅安装 ElixirLS 不够，它不提供 OTP 进程树或节点监控；必须用 erlang-ls 扩展（非 ElixirLS）才能看到 :observer.start() 级别的实时并发状态。
- 在 VSCode 扩展市场安装
erlang-ls（作者 erlang-ls），不是 ElixirLS - 项目根目录下创建
.vscode/launch.json，使用type: "erlang"配置而非mix_task - 关键字段必须包含：
"node": "test@127.0.0.1"、"setcookie": "abc"、"startFun": "application:start"、"startArgs": "[myapp]" - 启动后，在调试侧边栏能看到「Processes」、「Ports」、「Applications」等标签页，点击任意进程可查看收发消息队列
避免 mix_task 调试模式破坏分布式上下文
用 type: "mix_task" 启动 phx.server 或 run 时，ElixirLS 默认以单节点、无名方式运行，Node.self() 返回 :nonode@nohost，所有 Node.connect/1 调用静默失败。
- 不要用
mix_task配置调试分布式逻辑——它只适合本地单节点开发 - 需要多节点协作验证？改用
erlang类型配置，并在startFun中显式调用:net_kernel.start/1和Node.start/2 - 若必须从 Mix 启动，可在
config/runtime.exs中强制设置：System.put_env("ELIXIR_ERL_OPTIONS", "-name myapp@127.0.0.1 -setcookie abc") -
mix compile报错 “could not find application :kernel” 通常是-name冲突或 cookie 不匹配，不是代码问题
Livebook + VSCode 协同验证 Actor 行为
VSCode 编辑器无法实时重绘 Actor 交互流，但 Livebook 可补足这一环：它能在 notebook 中动态 spawn 进程、发送消息、观察 mailbox，再把结论反哺到 VSCode 中的模块设计。
- 终端执行
mix archive.install hex livebook后，运行livebook server - 在 Livebook cell 中写：
pid = spawn(fn -> receive do msg -> IO.inspect(msg) end end)，再send(pid, :hello) - VSCode 中对应模块用
GenServer实现时，可对照 Livebook 输出检查 handle_call/handle_info 是否覆盖了全部消息路径 - 注意 Livebook 默认使用
:nonode@nohost，跨节点测试仍需回到erlang-ls调试器
真正卡住人的从来不是配置项本身，而是误以为“装了插件=有了分布式能力”。Erlang 分布式节点一旦启动失败，VSCode 调试器不会报错，只会安静地显示空进程列表——你得去 Output 面板切到 erlang-ls 标签，看第一行是否写着 Failed to start distributed node。
