VSCode与Elixir/Phoenix开发环境设置

13次阅读

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

VSCode与Elixir/Phoenix开发环境设置

如果您希望在本地搭建一个用于Elixir和Phoenix框架开发的VSCode编辑环境,则需要配置语言支持、调试能力及项目集成工具。以下是完成该环境设置的具体步骤:

本文运行环境:macBook air,macOS Sequoia。

一、安装Elixir与Erlang运行时

VSCode本身不提供Elixir执行能力,需先在系统中安装Elixir及其依赖的Erlang/OTP。这是所有后续扩展和调试功能正常工作的基础。

1、打开终端,使用Homebrew执行安装命令:brew install erlang elixir

2、验证安装是否成功:在终端中输入elixir –versionerl,确认输出包含版本号且无报错。

3、确保PATH环境变量已包含Elixir可执行路径,通常为/opt/homebrew/binapple 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+Pmacos),输入并选择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}

3、保存后,在router.ex中输入phx_route并按Tab键,即可快速展开为完整路由定义。

text=ZqhQzanResources