MacOS下Vapor 4调试：如何实现实时单步调试与变量检查

环境 #

• Vapor 4.77+
• MacOS 13.4.1

目标 #

实现类似Xcode调试iOS/MacOS应用的体验：实时单步执行Vapor代码、检查变量与元素。

示例代码片段 #

struct FormData: Content {
    let name: String
    let image: File
}    

struct MultiPartController: RouteCollection {
    func boot(routes: RoutesBuilder) throws {
        let multiPartRoute = routes.grouped("MultiPart")
        multiPartRoute.on(.POST, body: .collect(maxSize: "10mb"), use: uploadMultiParts)
    }

    func uploadMultiParts(req: Request) throws -> EventLoopFuture<String> {
        do {
            let form = try req.content.decode(FormData.self)

            let name = form.name
            let imageFile = form.image

            // Get image data and filename
            let imageData = imageFile.data
            let filename = imageFile.filename
            // ...

调试尝试与问题 #

执行swift run --debugger进入LLDB环境后，执行step命令报错：

/Users/username/workarea/vapor/imageserverclient/imageuploadvapor> swift run --debugger
Building for debugging...
Build complete! (0.37s)
(lldb) target create ".build/arm64-apple-macosx/debug/App"
Current executable set to '/Users/username/workarea/vapor/imageserverclient/imageuploadvapor/.build/arm64-apple-macosx/debug/App' (arm64).
(lldb) step
error: Command requires a current process.

核心疑问：是否需要启动并行进程并按PID调试？如何实现Xcode式的实时调试操作？

解决方案 #

方案一：LLDB命令行调试（无需额外进程） #

你遇到的错误是因为没有启动目标进程，LLDB的step命令需要进程处于运行状态。正确流程：

1. 终端执行swift run --debugger进入LLDB环境
2. 输入run命令启动Vapor服务进程
3. 设置断点，例如：

   breakpoint set --file MultiPartController.swift --line 15
   

   （替换为你需要断点的文件名和行号）
4. 发送请求触发断点后，即可使用LLDB调试命令：
   • step：单步进入函数
   • next：单步跳过当前行
   • frame variable：查看当前栈帧的所有变量
   • print <变量名>：打印指定变量值

方案二：Xcode原生调试（最贴近需求） #

直接用Xcode打开Vapor项目，完全复刻iOS/MacOS应用的调试体验：

1. 终端执行vapor xcode，生成Xcode项目文件
2. 打开生成的.xcodeproj文件
3. 在Xcode左侧导航栏选择App作为运行目标
4. 点击代码行号左侧设置断点（例如uploadMultiParts方法内的代码行）
5. 点击Xcode顶部运行按钮（或按Cmd+R）启动服务，控制台会输出启动日志
6. 发送请求触发断点后，即可像调试iOS/MacOS应用一样：
   • 单步执行/跳过代码
   • 在变量面板查看所有变量值
   • 添加监视表达式追踪数据变化
   • 查看调用栈信息

内容的提问来源于stack exchange，提问作者Frederick C. Lee