PureScript新手常见问题及解决方法：需全局安装purs（npm install -g purescript），确保PATH正确；VSCode跳转失效需启动purs ide server并匹配outputDir；watch模式需指定sources；类型悬停不全可用Show Type命令或手动请求IDE服务。
spago init 后 spago build 报错找不到 purs
很多朋友在迈出PureScript第一步时就卡住了：执行spago build，却提示找不到purs编译器。这其实是个典型的理解偏差——Spago本身只是个构建和依赖管理工具，它并不自带编译器，其背后调用的正是全局安装的PureScript编译器。
解决起来并不复杂，核心就是确保编译器在系统路径里：
- 最推荐的方式是直接通过npm安装：
npm install -g purescript，兼容性通常最好。 - 当然，用系统包管理器也行，比如macOS上
brew install purescript。 - 安装后，别忘了在终端里敲个
purs --version验证一下，能看到类似0.16.2的版本号才算成功。 - 如果明明装了却还是报错，那大概率是
$PATH环境变量没配置对。在Linux或macOS上，可以查一下npm的全局安装路径：npm config get prefix，然后确保这个路径下的bin文件夹被添加到了$PATH中。 - Windows用户需要特别注意：PowerShell和CMD的环境变量缓存有时不同步，安装完编译器后，最稳妥的办法是重启一下终端。
VSCode 中按 Ctrl+Click 无法跳转到 Data.Array 等标准库定义
代码明明没错，但在VSCode里想通过Ctrl+Click快速跳转到函数或类型的定义时，却发现毫无反应。别急着怀疑人生，这通常不是代码问题，而是驱动这一切的“后台引擎”——psc-ide服务——没有正确启动。
PureScript的智能提示、跳转和类型悬停，都重度依赖这个IDE服务。要让它跑起来，得手动配置一下：
- 在项目根目录下启动服务：
purs ide server --port 4242 --log-level debug。 - 关键一步：确保启动命令里的
--output-directory参数，与项目spago.dhall配置文件中的outputDir设置完全一致（默认都是"output"）。 - VSCode这边，必须安装官方的
PureScript IDE插件，并检查设置，确保purescript.enableIde选项是启用的。 - 插件默认会去连接
localhost:4242这个端口。如果端口被其他程序占用了，记得同步修改插件设置里的purescript.idePort。
spago build --watch 不触发重编译，或改了文件后类型错误没实时更新
Watch模式失效，改了代码却看不到实时编译结果？这多半不是遇到了Bug，而是文件监听的“雷达”没有扫到你编辑的文件，或者编译输出的目录出现了意外。
可以从这几个方向排查：
spago build --watch默认只监听src/**/*.purs和spago.dhall这两个路径。如果你的模块放在了lib/或test/目录下，就需要用--sources参数明确告诉它：spago build --watch --sources "src/**/*" "test/**/*"。- 每次执行
spago build，它都会清空output/目录然后重新构建。如果同时有其他工具（比如Webpack）也在读写这个目录，就可能产生冲突。一个良好的习惯是：把output/加入.gitignore，并且不要手动去删除它。 - 有时候，VSCode插件会缓存旧的类型信息。如果你明明已经修正了类型错误，但提示依然标红，可以尝试先关闭
purs ide server进程，然后重启VSCode的PureScript插件。
调试时想看某函数的完整类型签名，但悬停只显示简略版
遇到复杂的函数，把鼠标悬停上去，却只看到一个被截断的、不完整的类型签名，尤其是对于高阶函数或者带有类型约束（比如Monad、Eq）的情况。这其实是IDE为了界面简洁做的妥协，完整的类型信息其实藏在后台。
有两种更可靠的方法可以获取完整签名：
- 在VSCode里，把光标移动到函数名上，然后按
Ctrl+Shift+P打开命令面板，输入并执行PureScript: Show Type命令。这会弹出一个面板，显示包含所有类型变量和约束的完整签名。 - 更硬核一点，可以直接通过终端向IDE服务发送请求：
echo '{"command":"type","params":{"search":"map","currentModule":"Main"}}' | nc localhost 4242。当然，前提是purs ide server正在运行。 - 需要注意一个小细节：如果某个函数从未被任何模块导入或使用过，IDE服务可能会返回
not found。这时，可以尝试先在Main.purs里简单地调用它一次，再查询。
说到底，PureScript开发体验中最磨人的，往往不是某个具体的配置步骤，而是IDE服务、构建工具和输出目录三者之间的状态同步。修改了spago.dhall、清空了output/目录，或者重启了项目但忘了重启IDE服务，只要其中一环脱节，类型提示和跳转功能就可能失灵。一个实用的建议是：把这些启动和监控命令写进一个简单的shell脚本里，一键运行，省去每次手动记忆和输入的麻烦。
