如何设置VSCode以支持Elixir语言的高并发分布式编程？

本文共计1120个文字，预计阅读时间需要5分钟。

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。