WSL2环境下VSCode配置Haskell调试：断点无法触发求助

1. 项目构建与依赖有效性检查 #

• 确保stack build --test执行成功：必须先完成测试组件的完整编译，若存在语法、类型错误，调试器无法加载目标代码，断点自然不会触发。
• 验证调试工具的PATH配置：执行which haskell-debug-adapter，若返回空值，说明stack install的工具未加入可执行路径。需在WSL的~/.bashrc或~/.zshrc中添加export PATH="$HOME/.local/bin:$PATH"，重启终端或执行source ~/.bashrc生效。

2. launch.json配置修正 #

• 校验文件路径正确性：WSL环境下${workspaceFolder}对应WSL内的项目根目录，执行ls ${workspaceFolder}/test/Spec.hs确认目标文件存在。
• 调整调试配置逻辑：
  • 避免直接指定单个测试文件为program，改为指定项目根目录并添加测试参数，示例配置：

    {
        "name": "Haskell (stack test)",
        "type": "haskell",
        "request": "launch",
        "program": "${workspaceFolder}",
        "args": ["test"],
        "stopOnEntry": true,
        "ghciEnv": ["STACK_YAML=${workspaceFolder}/stack.yaml"]
    }
    

  • 添加stopOnEntry: true，先验证调试器是否能正常启动加载环境。

3. 断点设置合理性检查 #

• 断点需设置在可执行代码行：不能在注释、空行、类型签名或模块声明行设置断点，必须放在it测试块内的实际执行代码（如断言逻辑行）上。
• 确认测试用例未被跳过：若测试代码使用pending标记，断点不会触发，需移除该标记确保测试用例处于活跃状态。

4. 扩展与工具版本兼容 #

• 匹配HLS与调试工具版本：执行stack install hls --resolver lts-18.28安装稳定版Haskell Language Support（HLS），避免版本过高/过低与Phoityne扩展、调试适配器冲突。
• 使用stack resolver对应版本的调试工具：避免手动安装最新版haskell-dap、ghci-dap、haskell-debug-adapter，利用stack resolver自动拉取兼容版本。

5. WSL环境路径与权限 #

• 确保VSCode通过WSL终端启动：必须执行code .从WSL终端打开项目，避免Windows直接访问WSL路径导致的权限或路径解析异常。
• 项目目录避免特殊字符：路径中包含空格或特殊符号可能导致调试器无法正确识别文件，需使用纯英文无空格的目录结构。

内容的提问来源于stack exchange，提问作者edamondo