如何使用SublimeText运行Elixir程序？快速配置Elixir环境的指南

答案：通过安装Elixir、配置sublime Text的构建系统并使用LSP提升开发体验，可高效运行Elixir程序。首先确保Elixir正确安装，推荐使用asdf管理版本；接着在sublime text中通过Package Control安装Elixir语法包；然后创建自定义构建系统，如{ "cmd": ["elixir", "$file"], "file_patterns": ["*.ex"], "selector": "source.elixir", "working_dir": "$file_path", "shell": true}用于运行单个.ex文件，或使用”cmd”: [“mix”, “run”]、"working_dir": "$project_path"来运行mix项目；保存为Elixir.sublime-build后，在Tools > Build System中选择对应配置，按Ctrl+B即可运行；为进一步提升体验，可安装LSP包并配置elixir-ls实现自动补全、跳转定义等功能，同时结合SublimeLinter与Credo进行代码检查；若遇问题，需检查Elixir环境变量、构建系统JSON格式、working_dir路径及LSP日志，确保命令可在终端直接执行且路径正确。

在Sublime Text里运行Elixir程序，说实话，并不像在一些专门的ide中那样开箱即用，但通过一些简单的配置，你可以很快地搭建一个高效且舒适的开发环境。核心在于确保你的系统已经安装了Elixir，然后告诉Sublime Text如何去执行你的

.ex

文件，或者更常见的是，如何与

mix

项目交互。这并非什么复杂的技术活，更多的是一个习惯与偏好的选择。

要让Sublime Text能够愉快地运行你的Elixir代码，你需要做几件事。首先，确保你的系统已经正确安装了Elixir。我个人比较推荐使用

asdf

版本管理器来安装Elixir，这样可以轻松切换不同版本，避免版本冲突带来的麻烦。如果你是macOS或linux用户，直接通过

brew install elixir

或者从官网下载安装包也行。

接下来，打开Sublime Text。

你需要一个能够高亮Elixir语法的包。通过

Package Control

（如果没装，按

Ctrl+Shift+P

，输入

Install Package Control

并回车），搜索并安装

Elixir

这个包。这能让你的代码看起来赏心悦目，语法高亮、自动补全等基础功能就有了。

重头戏来了，我们需要创建一个自定义的构建系统（Build System）。这个系统会告诉Sublime Text，当你按下

Ctrl+B

（或

Cmd+B

）时，应该执行什么命令。

选择

Tools > Build System > New Build System...

。

一个新的文件会打开，里面通常是空的或者有一些默认的json结构。把下面的内容粘贴进去：

{     "cmd": ["elixir", "$file"],     "file_patterns": ["*.ex"],     "selector": "source.elixir",     "working_dir": "$file_path",     "shell": true }

然后将这个文件保存为

Elixir.sublime-build

（名字可以自定义，但要以

.sublime-build

结尾）在Sublime Text建议的默认路径下。

这个配置的含义是：

• "cmd": ["elixir", "$file"]

  : 当你运行这个构建系统时，它会执行

  Elixir

  命令，并把当前打开的文件（

  $file

  ）作为参数传给它。这适用于运行单个Elixir脚本。

• "file_patterns": ["*.ex"]

  : 让Sublime Text知道这个构建系统适用于

  .ex

  文件。

• "selector": "source.elixir"

  : 进一步指定它适用于Elixir源代码。

• "working_dir": "$file_path"

  : 确保命令在当前文件所在的目录下执行，这对于一些需要相对路径的脚本很重要。

• "shell": true

  : 在一个shell中执行命令，这样可以正确解析环境变量。

如果你主要是在

mix

项目里工作，你可能更希望运行

mix run

或者

mix test

。你可以创建另一个构建系统，或者修改现有的：

运行Mix项目（例如：

mix run

）

{     "cmd": ["mix", "run"],     "selector": "source.elixir",     "working_dir": "$project_path", // 或者 "$file_path" 如果你习惯在文件所在目录执行     "shell": true }

注意这里的

"working_dir": "$project_path"

，它会把工作目录设置到你当前Sublime项目（如果已保存为

.sublime-project

文件）的根目录，这通常是

mix

项目的根目录。

运行Mix测试（例如：

mix test

）

{     "cmd": ["mix", "test", "$file"], // 或者只用 ["mix", "test"] 运行所有测试     "selector": "source.elixir",     "working_dir": "$project_path",     "shell": true }

保存好这些

.sublime-build

文件后，回到你的Elixir代码文件，通过

Tools > Build System

选择你刚刚创建的构建系统（例如

Elixir

或

Elixir Mix Run

）。然后按下

Ctrl+B

（或

Cmd+B

），Sublime Text底部的控制台就会显示你的Elixir程序的输出。

为什么选择Sublime Text而不是功能更全面的IDE来开发Elixir？

选择开发工具，很多时候是个人习惯和项目需求的交织。说实话，面对像VS Code、IntelliJ idea这类功能强大的IDE，Sublime Text显得有些“简陋”。但对我个人来说，以及很多老牌开发者而言，Sublime Text的魅力在于它的轻量和极速。启动快，操作流畅，即使打开巨型项目文件也不会卡顿，这在处理大量代码时是无与伦比的优势。

我个人觉得，Elixir开发本身就高度依赖终端，

iex

交互式Shell、

mix

命令行的使用频率非常高。很多时候，我们编译、测试、运行都是在独立的终端窗口完成的。在这种背景下，一个功能臃肿的IDE反而显得有些多余，它提供的集成终端、调试器等功能，我可能并不会全部用到。Sublime Text的哲学更像是“给你一个强大的文本编辑器，剩下的你自己配置”。这种高度的自定义能力，让我们可以根据自己的工作流，精确地配置构建系统、快捷键、代码片段，打造一个完全符合个人习惯的环境。

此外，Sublime Text的多光标编辑和命令面板功能，对于快速编辑和重构代码效率极高，这是很多IDE难以比拟的。它更像一个“程序员的瑞士军刀”，专注于文本操作本身，而将其他复杂的任务留给外部工具或我们自己的脚本。这种专注，有时候反而能带来更高的效率和更少的干扰。当然，这并不是说IDE不好，只是在Elixir这种生态下，Sublime Text的这种“极简而强大”的风格，对我来说，往往更能击中痛点。

如何优化Sublime Text的Elixir开发体验？

仅仅能运行Elixir程序还不够，我们当然希望在Sublime Text里也能获得接近IDE的智能体验。这并非不可能，关键在于利用好Sublime Text的包生态和一些现代工具。

首先，语言服务器协议（LSP）是提升开发体验的关键。你需要安装Sublime Text的

LSP

包，然后配置它来使用

elixir-ls

。

elixir-ls

是Elixir社区官方推荐的语言服务器，它能为Sublime Text带来：

• 代码自动补全：根据上下文智能提示函数、模块等。
• 跳转到定义：快速查看函数或宏的原始定义。
• 悬停文档：鼠标悬停在函数上时显示其文档。
• 错误和警告提示：实时在编辑器中显示语法错误和潜在问题。

安装

LSP

包后，通常还需要在

LSP

的设置中添加

elixir-ls

的配置。这通常涉及到指定

elixir-ls

可执行文件的路径。如果

elixir-ls

没有自动安装，你可能需要手动通过

mix archive.install hex elixir_ls

来安装它。

其次，代码片段（Snippets）是提高编码速度的利器。Sublime Text允许你创建自定义的代码片段。比如，你可以创建一个输入

defp

然后按

Tab

就能自动展开成

defp func_name(args) do ... end

的片段。很多Elixir包已经提供了不错的代码片段，但根据个人习惯定制一些常用结构会让你飞快地写代码。

再者，Linting工具能帮助你保持代码风格和质量。结合

SublimeLinter

包和Elixir的linting工具（比如

Credo

），可以在你编码时实时检查代码规范。当代码不符合规范时，编辑器会给出视觉提示，帮助你养成良好的编码习惯。

最后，不要忽视自定义快捷键。将你最常用的构建系统（比如

mix test

）绑定到一个方便的快捷键上，能让你在开发过程中无需离开键盘就能快速执行测试或运行程序。例如，我经常把

Ctrl+Shift+T

绑定到运行当前文件的测试上，非常方便。

遇到Elixir环境配置问题时，如何进行故障排除？

即使按照指南一步步操作，也难免会遇到一些“奇怪”的问题，这是软件开发的一部分。当Sublime Text无法正常运行Elixir程序时，通常有几个方向可以排查：

1. Elixir环境本身的问题：

• 检查Elixir是否安装并可执行： 打开你的终端，输入

  elixir -v

  和

  mix -v

  。如果这些命令不能正常显示版本信息，或者提示

  command not found

  ，那么问题出在Elixir的安装上，而不是Sublime Text。你需要重新检查Elixir的安装，并确保它的可执行路径（通常是

  ~/.asdf/shims

  或

  /usr/local/bin

  等）已添加到系统的

  PATH

  环境变量中。

• asdf

  版本管理器问题： 如果你使用

  asdf

  ，确保你在项目目录下运行了

  asdf local elixir <version>

  ，并且

  asdf reshim elixir

  也执行过。有时候

  asdf

  的环境没有正确加载，会导致Sublime Text找不到正确的Elixir版本。

2. Sublime Text构建系统配置问题：

• JSON语法错误： 检查你的

  .sublime-build

  文件，JSON格式对逗号、引号、括号非常敏感。一个小小的语法错误都可能导致构建系统无法工作。你可以使用在线JSON校验工具检查。

• cmd

  路径问题： 尽管

  "shell": true

  通常能解决大部分路径问题，但如果你的

  Elixir

  或

  mix

  命令不在标准的

  PATH

  路径下，Sublime Text可能仍然找不到它们。尝试在

  cmd

  中提供完整的路径，例如

  ["/usr/local/bin/elixir", "$file"]

  。

• working_dir

  设置： 如果你正在运行

  mix

  命令，但

  working_dir

  设置不正确（例如指向了单个文件所在的目录而不是

  mix

  项目的根目录），

  mix

  命令会报错说找不到

  mix.exs

  。确保

  working_dir

  指向

  mix

  项目的根目录，通常是

  "$project_path"

  。

3. Sublime Text控制台输出：

• 查看错误信息： 在Sublime Text中，通过

  View > Show console

  打开控制台。当构建系统失败时，这里通常会打印出详细的错误信息。这些信息是诊断问题的关键线索。它会告诉你Sublime Text尝试执行了什么命令，以及为什么失败。

4. LSP和

elixir-ls

问题：

• LSP

  日志： 如果是代码补全、跳转定义等功能失效，检查

  LSP

  包的日志。通常在

  Tools > LSP > View Log

  中可以找到。日志会显示

  elixir-ls

  是否成功启动，以及它在运行时遇到了哪些错误。

• elixir-ls

  版本： 确保你安装的

  elixir-ls

  版本与你的Elixir版本兼容。有时候旧版本的

  elixir-ls

  不支持新版Elixir的特性。

通过系统地排查这些可能的问题，你通常能找到并解决Sublime Text运行Elixir程序时遇到的配置难题。记住，很多时候，问题并不在于工具本身，而是工具与环境之间的“沟通”出了点岔子。