配置Atom作为Dart编辑器时，常见问题并不是插件没装，而是运行方式、环境变量或SDK路径没有配对。 明明插件装了却运行不了，或者提示找不到命令，又或者Web项目跑不起来，这些情况其实都有明确的解决路径。下面把几个常见卡点拆开来说。

Atom安装Dart插件后为什么运行不了.dart文件？

这个问题很简单：Atom本身不带Dart运行时。

只装了dart插件，比如dart-tools，它只能提供语法高亮和基础的代码补全。要真正运行代码，还得有script或atom-dart-runner这类执行器插件。

否则，按Ctrl+Shift+B不会触发dart run。这是新手最容易卡住的地方。

解决方案

• 先装两个核心插件：dart（官方语言支持）和script（通用脚本执行器）
• 打开Atom → Preferences → Packages → script → Settings，对script插件进行额外配置
• 在Command字段填入dart——前提是dart已加入系统PATH，运行dart --version能正常返回版本号
• 在Arguments字段填入run {FILE_ACTIVE}（注意空格，大括号是Atom的变量语法）
• 保存后重启Atom，再用Ctrl+Shift+B就能直接运行.dart文件了

Mac上dart命令找不到，但brew install dart明明成功了？

这是个常见环境问题。

Homebrew安装的Dart SDK默认路径是/opt/homebrew/opt/dart/libexec（Apple Silicon）或/usr/local/opt/dart/libexec（Intel）。虽然brew install dart会把dart命令软链到/opt/homebrew/bin/dart，但Atom的script插件有时会继承错误的shell环境，读不到这个路径。

先验证问题是否出在环境加载

在Atom内置终端（Ctrl+Shift+T）里执行which dart。如果返回为空，说明Atom没加载你的shell配置，比如.zshrc。

几个解决思路

• 临时方案：在Atom内置终端中手动执行source ~/.zshrc，再试dart --version
• 长期方案：在Atom → Config…中找到core设置项，勾选Use Core Shell Environment
• 更稳妥的做法：直接把dart的绝对路径写进script插件的Command字段，比如/opt/homebrew/bin/dart

为什么Atom跑Dart Web项目总报“Failed to load script”？

这个问题的根源，不在代码本身，而在运行方式错了。

Atom的script插件默认按CLI模式执行，它会把.dart文件当作普通脚本来直译运行。但Web项目不一样，它需要编译成Ja vaScript，再托管在HTTP服务下，直接用dart run启动是不行的。

如果你的项目包含web/index.html和web/main.dart，想在浏览器中调试，就得换工具链。

正确处理方式

• 先删掉script插件对.dart文件的默认绑定，避免误触发
• 改用web-dev-server：全局安装dart pub global activate webdev
• 在项目根目录运行webdev serve，然后手动打开http://localhost:8080
• Atom里可以配合platformio-ide-terminal插件开一个专用终端来跑webdev，比硬塞进script更可控

Atom里没有Dart强模式（strong mode）提示？

Dart 2.12+已经默认启用null safety，不再提“strong mode”这个概念。

但Atom的dart插件如果没有连接到Dart分析服务器（dartanalyzer或LSP），就无法提供类型推导、未使用变量警告等静态检查。

关键不在于插件装没装，而在于dart SDK路径是否被正确识别。

排查步骤

• 打开Atom → Preferences → Packages → dart → Settings
• 检查Dart SDK Path是否为空。如果为空，点击右侧的Locate SDK，指向你本地的dart-sdk目录（比如/opt/homebrew/opt/dart/libexec）
• 确认Enable LSP已勾选（推荐开启，比旧版analysis server更稳定）
• 重启Atom，打开任意.dart文件，等待右下角出现“Analyzing…”提示消失，再看看类型错误是否实时标红

路径配错是Atom里Dart功能“半残”的最常见原因，比插件版本问题更值得优先排查。