首先安装 Erlang 和 Elixir 并推荐使用 asdf 进行版本管理，依次添加插件并安装最新版本，设置全局版本；接着在 VSCode 中安装 ElixirLS 扩展以支持智能提示、调试等功能；打开 mix 项目后等待 ElixirLS 自动构建，验证悬停提示与跳转功能；最后启用保存时自动格式化并在 settings.json 中配置 editor.formatOnSave，确保 shell 正确加载 asdf 环境变量以避免路径问题。
在 VSCode 中配置 Elixir 开发环境，关键在于安装合适的扩展和工具链，确保代码编辑、自动补全、调试和格式化都能顺畅运行。核心组件包括 Elixir LS（Language Server）、Erlang/OTP 环境以及 VSCode 的配套插件。
安装 Erlang 和 Elixir
确保系统中已正确安装 Erlang 和 Elixir，这是运行 Elixir 项目的基础。
- 推荐使用 asdf（多语言版本管理工具）来安装 Erlang 和 Elixir，避免版本冲突
- 安装 asdf 后，添加插件：asdf plugin-add erlang 和 asdf plugin-add elixir
- 通过 asdf install erlang latest 和 asdf install elixir latest 安装最新版本
- 设置全局版本：asdf global erlang latest 和 asdf global elixir latest
安装 VSCode 扩展
VSCode 需要语言服务器支持才能提供智能提示、跳转定义等功能。
- 打开扩展市场，搜索并安装 ElixirLS: Elixir support and debugger
- 该扩展基于 ElixirLS，集成了语言服务器和调试器，支持自动补全、错误检查、文档查看等
- 可选安装 vscode-elixir 提供基础语法高亮（但主要功能已被 ElixirLS 覆盖）
验证项目配置
打开一个 Elixir 项目（mix 项目）后，ElixirLS 会自动启动并编译项目以提供语义支持。
- 确保项目根目录有 mix.exs 文件
- 首次打开时，VSCode 底部状态栏会显示 “Building project…”
- 构建完成后，悬停函数可看到类型签名，F12 可跳转定义，Ctrl+Space 触发补全
- 若未启动，检查输出面板中的 “ElixirLS” 日志，排查路径或依赖问题
启用格式化与集成设置
让编辑器保存时自动格式化代码，保持风格统一。
- 在 VSCode 设置中启用：Editor: Format On Save
- ElixirLS 默认使用 mix format，确保项目中已配置 .formatter.exs
- 可在 settings.json 中添加： { "editor.formatOnSave": true }
- 调试功能支持断点调试，点击左侧边栏“运行和调试”图标，创建 launch.json 启动配置
基本上就这些。只要 Erlang/Elixir 环境正常，扩展安装成功，大多数功能都会自动生效。遇到问题优先检查 asdf 是否正确导出环境变量，以及 VSCode 是否使用了正确的 shell 上下文。不复杂但容易忽略的是 shell 集成——如果终端能运行 elixir --version，但 VSCode 不能，很可能是启动方式未加载 asdf shims。
