ElixirLS快速上手：打开第一个Mix项目，代码补全与悬停文档立竿见影

ElixirLS快速上手打开第一个Mix项目代码补全与悬停文档立竿见影【免费下载链接】vscode-elixir-lsElixir language support and debugger for VS Code, powered by ElixirLS.项目地址: https://gitcode.com/gh_mirrors/vsc/vscode-elixir-lsvscode-elixir-lsElixirLS是 VS Code 上最主流的 Elixir 语言支持扩展由 ElixirLS 语言服务器驱动提供代码补全、悬停文档、ExUnit 测试运行、断点调试和 Dialyzer 类型分析等一整套功能。本文是一份面向新手的最快上手指南只需打开第一个 Mix 项目就能立刻用上智能提示与悬停文档。它能为你的 Elixir 开发带来什么安装完成后你会获得以下核心能力✨代码补全模块、函数、宏、属性自动提示基于真实项目类型推断悬停文档鼠标停在函数上即可查看文档、类型签名和spec测试支持Test Explorer 一键运行/调试 ExUnit 测试调试器对 Mix 任务与测试打断点、单步执行、查看变量与调用栈Dialyzer 分析增量类型检查还能自动生成spec建议⚡格式化按 Elixir 官方风格自动排版保存时格式化或AltShiftF导航能力跳转定义、查找引用、文档与全局符号准备工作安装 Elixir 与扩展一键安装步骤ElixirLS不自带Elixir 运行环境它直接使用你系统上已安装的 Elixir 与 Erlang/OTP这也是它启动快的关键。安装运行时使用 asdf、mise 等版本管理器或按官方指南安装 Erlang/OTP 与 Elixir。装好后在终端执行elixir --version能同时打印出 Elixir 和 OTP 版本号即表示成功。安装扩展在 VS Code 扩展市场中搜索ElixirLS: Elixir support and debugger发布者 JakeBecker点击安装。注意从终端启动 VS CodeElixirLS 继承 VS Code 所在环境中的PATH通过终端code .打开项目最稳妥。 详细步骤可参考项目内置引导文档walkthroughs/install-elixir.md。打开第一个 Mix 项目ElixirLS 自动激活这是最容易的一步也是最多人卡住的一步用文件 → 打开文件夹打开包含mix.exs的目录扩展会自动激活并开始编译项目。首次启动较慢属正常现象——它需要拉取依赖、编译项目并建立索引之后的每次启动都是增量编译速度会快很多。Umbrella / monorepo 项目如果mix.exs不在工作区根目录在设置中把elixirLS.projectDir指向正确的子目录即可。⚠️工作区信任提示ElixirLS 编译项目时会执行项目及依赖中的代码包括宏和构建脚本因此它只在受信任的工作区中运行。只打开你信任的项目源码。 该行为由扩展的激活事件控制源码见 package.json 中的activationEvents字段配置说明见walkthroughs/open-project.md。代码补全与悬停文档立竿见影的智能体验项目编译完成后效果立刻显现输入.或函数名首字母补全列表会出现当前模块的函数、依赖库的公开 API且顺序按实际类型排序鼠标悬停在任意函数上弹出面板展示文档、参数签名与spec输入do、fn -时编辑器自动补全配对代码块由editor.formatOnType驱动函数调用时还会显示参数签名提示减少查文档次数。扩展同时为 Elixir 文件预设了合理的编辑器行为2 空格缩进、自动删除行尾空格、文件末尾保留单个换行、智能补全代码块等开箱即用无需手动配置。运行与调试 ExUnit 测试ElixirLS 将 ExUnit 深度集成进 VS Code 的Test Explorer活动栏上的烧瓶图标test/**/*_test.exs中的测试会自动以树状结构列出内联按钮可直接运行单个测试、整个文件或全部测试套件点击调试图标可调试测试支持断点与单步失败断言会内联显示 diff一眼定位问题。如果你更喜欢在源码上方直接操作开启elixirLS.enableTestLenses设置后每个测试上方会显示 Run test 代码透镜点击即跑断点调试 Mix 任务与测试调试是 ElixirLS 最被低估的能力之一在运行和调试视图中选择mix task配置输入任意 Mix 任务名如mix test、mix phx.server在代码行号旁点击设置断点启动调试会话触发断点后左侧面板展示变量、监视表达式、调用栈底部可打开调试控制台执行 Elixir 表达式。前面第一张截图展示的正是一个典型的调试现场Phoenix 路由请求命中断点后可以逐层查看Plug.Conn结构体、params等内容排查问题比IO.inspect高效得多。常用设置速查表ElixirLS 开箱即用以下是最常调整的几个设置设置面板搜索elixirLS即可找到设置项作用elixirLS.projectDir指定mix.exs所在子目录Umbrella/monorepo 必备elixirLS.mixEnv/elixirLS.mixTarget编译时使用的MIX_ENV默认 test与MIX_TARGET默认 hostelixirLS.dialyzerEnabled开关增量 Dialyzer 类型分析默认开启elixirLS.suggestSpecs根据推断类型内联提示spec注解elixirLS.enableTestLenses在测试上方显示 Run/Debug 代码透镜elixirLS.fetchDeps编译前自动拉取依赖Dialyzer 提示首次运行会为项目与依赖构建 PLT 数据库可能需要几分钟之后均为增量分析只在变更部分重新检查。遇到问题怎么办快速排错清单确认已安装hex与git且能正常访问 Hex 包仓库代理环境可能需要配置 HTTPS 代理通过查看 → 输出在下拉框中选择ElixirLS查看日志——这是定位问题的第一现场使用命令面板运行restart命令重启语言服务器或运行mixClean清理编译产物仍不行关闭编辑器后删除项目下的.elixir_ls目录再重启注意这会重新触发完整的 Dialyzer 构建。 完整排错指南见README.md的 Troubleshooting 章节配置详解见walkthroughs/configure.md。小结回到本文的核心路径安装 Elixir 运行时 → 安装 ElixirLS 扩展 → 打开含mix.exs的文件夹三步之后你就能在第一个 Mix 项目中享受实时代码补全、悬停文档、测试运行与断点调试。对于新手来说这是目前在 VS Code 里写 Elixir 成本最低、体验最完整的方案强烈建议今天就装上一个试试。【免费下载链接】vscode-elixir-lsElixir language support and debugger for VS Code, powered by ElixirLS.项目地址: https://gitcode.com/gh_mirrors/vsc/vscode-elixir-ls创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考