需先安装erlang与Elixir运行时,再配置vscode的ElixirLS扩展、Phoenix项目环境、调试launch.json及自定义代码片段,以实现完整的本地开发支持。

如果您希望在本地搭建一个用于Elixir和Phoenix框架开发的VSCode编辑环境,则需要配置语言支持、调试能力及项目集成工具。以下是完成该环境设置的具体步骤:
本文运行环境:macBook air,macOS Sequoia。
一、安装Elixir与Erlang运行时
VSCode本身不提供Elixir执行能力,需先在系统中安装Elixir及其依赖的Erlang/OTP。这是所有后续扩展和调试功能正常工作的基础。
1、打开终端,使用Homebrew执行安装命令:brew install erlang elixir。
2、验证安装是否成功:在终端中输入elixir –version与erl,确认输出包含版本号且无报错。
3、确保PATH环境变量已包含Elixir可执行路径,通常为/opt/homebrew/bin(apple Silicon)或/usr/local/bin(Intel Mac)。
二、配置VSCode核心扩展
VSCode需通过官方认可的扩展实现语法高亮、智能提示、代码格式化及调试支持。这些扩展协同工作,构成完整的Elixir/Phoenix开发体验。
1、启动VSCode,在扩展市场中搜索并安装ElixirLS: Elixir Support(由JakeBecker维护,官方推荐)。
2、安装后重启VSCode,确保状态栏右下角显示Elixir语言模式,并能识别.ex与.exs文件。
3、启用自动格式化:进入设置,搜索elixir.formatOnSave,勾选该项以在保存时自动应用mix format规则。
三、初始化Phoenix项目并关联VSCode
Phoenix项目结构依赖mix工具链生成,VSCode需正确识别_mix.lock_、_config/_等目录以激活项目级功能(如任务运行、测试集成)。
1、在终端中执行mix phx.new hello_world –no-ecto(跳过数据库以简化初始配置)。
2、进入项目根目录:cd hello_world。
3、在当前目录中启动VSCode:code .,确保工作区加载了_mix.exs_与_config/config.exs_等关键文件。
四、启用调试支持
ElixirLS内置调试适配器,但需手动创建launch.json配置才能在VSCode中启动Phoenix服务器或运行测试。
1、在VSCode中按下Cmd+Shift+P(macos),输入并选择Debug: Open launch.json。
2、选择环境为Elixir,自动生成模板文件,替换其内容为以下配置:
{“version”: “0.2.0”,”configurations”: [{“type”: “mix_task”,”name”: “phx.server”,”request”: “launch”,”projectDir”: “${workspaceRoot}”,”task”: “phx.server”,”taskArgs”: []}]}。
3、在任意.ex文件中设置断点,按F5启动调试,观察调试控制台输出Phoenix启动日志。
五、配置代码片段与快捷键
Phoenix开发中高频使用路由定义、控制器动作、html模板插值等结构,通过自定义代码片段可显著提升编码效率。
1、在VSCode中执行Preferences: Configure User Snippets,选择Elixir语言。
2、添加新片段,例如名为phx_route的条目,其body为:get “/”, ${1:PageController}, :${2:index}。