必须先确保 Julia REPL 正常启动：终端 julia --version 要成功输出版本号；首次 REPL 需等待 Pkg.precompile() 完成、状态栏显示 Julia v1.x.x；禁用非官方 Julia 插件，避免 LSP 冲突。
调试前必须确保 Julia REPL 能正常启动
VSCode 的 Julia 调试器（julia-vscode）不是独立运行的，它依赖已成功启动的 REPL 和语言服务器。如果 Julia: Start REPL 点击后卡在 “Starting Julia” 或状态栏显示 “Not found”，调试功能一定不可用——此时别急着配 launch.json，先解决环境基础问题。
常见卡点：
-
julia --version在系统终端（非 VSCode 内置终端）中必须能立即输出版本号；若失败，julia.executablePath配得再准也白搭 - 首次启动 REPL 时，插件会自动触发
Pkg.precompile()，可能持续 10–30 秒；状态栏未出现Julia v1.x.x提示前，不要关闭或重试 - 装了多个 Julia 插件（比如非
JuliaEditorSupport发布的“Julia Support”），会导致 LSP 冲突，补全和调试均静默失效
launch.json 中最关键的三项配置
调试入口是 .vscode/launch.json，但多数人直接复制模板却忽略三个硬性约束：
-
"program": "${file}"：只对已保存的.jl文件生效；未保存的临时文件、.txt或无后缀文件不会被识别为可调试目标 -
"project": "${command:activeJuliaEnvironment}"：必须与当前脚本所在目录的 Julia 环境一致；若该目录有Project.toml，但里面没声明Plots，调试时using Plots就会报UndefVarError -
"stopOnEntry": false：设为true会让调试器一启动就停在第一行，容易误判为卡死；建议保持false，靠手动加断点控制流程
最小可用配置示例：
{
"version": "0.2.0",
"configurations": [
{
"type": "julia",
"name": "Debug Julia Program",
"request": "launch",
"program": "${file}",
"stopOnEntry": false,
"project": "${command:activeJuliaEnvironment}"
}
]
}
断点不命中？检查文件上下文和包环境
点击行号左侧加断点后程序未暂停，大概率不是调试器坏了，而是执行上下文不匹配：
- 右下角状态栏语言模式必须是
Julia（不是Plain Text），否则断点注册失败 - 调试运行的是当前打开的文件，但
using或include的模块若不在同一环境里，断点可能跳过——例如你在全局@v1.10环境调试，但include("utils.jl")里的函数定义在另一个项目环境，断点不会触发 - 使用
Revise.jl时，热重载可能导致断点失效；临时禁用它（注释掉using Revise）可验证是否为此原因
变量监视失效或值显示为 #undef
调试时鼠标悬停看不到变量值、监视面板显示 #undef，通常是因为作用域或编译优化导致：
- 变量定义在
let块或匿名函数内，且未被实际调用，JIT 可能跳过编译，调试器无法捕获其值 - 函数被
@inline标记，或在__init__中定义但未显式调用，调试器无法插入断点或读取局部变量 - 数组过大（如
rand(10^7)）时，VSCode 默认限制展开深度；可在调试控制台手动输入summary(x)或size(x)查看概况
真正难搞的是多线程场景：Julia 的 @threads 或 Threads.@spawn 创建的线程默认不被主调试会话捕获，断点只对主线程有效。需要切到“调用栈”面板手动选择线程帧，但前提是该线程已执行到断点位置——这点极易被忽略，且无明确错误提示。
