VSCode中dagger命令失败主因是CLI未正确安装或PATH未配置、Python环境未激活、配置文件无语法支持、调试未启用--debug参数；需重装CLI、选对venv解释器、安装Dagger及YAML插件、配置launch.json并显式加--debug。
VSCode里跑不了 dagger do？先确认Dagger CLI是否真在PATH里
很多人执行 dagger do 报错 command not found，不是VSCode配置问题，而是Dagger CLI根本没装对或没进系统PATH。VSCode终端（哪怕开了新窗口）默认继承系统shell环境，但如果你用Homebrew装的Dagger，又用了zsh但没把 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）加进 ~/.zshrc，VSCode就找不到它。
- 在VSCode集成终端里直接运行
which dagger，没输出就说明CLI不可见 - 别依赖“已安装”印象——重装一次：用
curl -L https://dl.dagger.io/dagger/install.sh | sh装，它会自动写入正确路径 - 改完shell配置后，必须完全重启VSCode（不只是关终端），否则环境变量不刷新
调试 dagger.dev 项目时，dagger run 报 no module named 'dagger'
这是Python SDK常见陷阱：你本地Python环境里没装 dagger-io 包，但VSCode又没激活对应venv，导致 dagger run 启动的Python进程找不到SDK。Dagger CLI本身不依赖Python，但它执行Python写的pipeline时，会调用你代码里 import dagger —— 这个导入失败就停在这儿。
- 确保项目根目录有
requirements.txt，且含dagger-io>=0.11（注意版本号要匹配你用的Dagger CLI大版本） - 在VSCode里按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），搜 “Python: Select Interpreter”，选中项目下的venv（比如.venv/bin/python） - 别用全局Python解释器——Dagger Python SDK和CLI版本强耦合，混用会触发奇怪的序列化错误
编辑 dagger.json 或 dagger.dev.yml 时没有语法提示和校验
VSCode默认不认Dagger配置文件格式，所以你敲错字段名、缩进错位、漏掉必填项，全靠手动排查。这不是功能缺失，是没装对插件或没配语言关联。
- 装官方插件：
Dagger（Publisher: Dagger）——注意不是第三方同名插件 - 在VSCode设置里搜
files.associations，加一条："dagger.dev.yml": "yaml"；如果用JSON配置，加"dagger.json": "json" - YAML模式下，装
Red Hat YAML插件并启用yaml.schemas，指向Dagger官方schema地址（当前是https://raw.githubusercontent.com/dagger/dagger/main/sdk/python/dagger/jsonschema.json）
断点调试Python pipeline卡在 dagger run 启动阶段，进不去函数
VSCode默认调试器不接管 dagger run 启动的子进程，所以你在 func main() 打断点毫无反应。这不是代码问题，是调试链路没打通。
- 不用
Debug: Start Debugging直接跑，改用终端命令：dagger run --debug python main.py（假设入口是main.py） - 在VSCode里新建一个
.vscode/launch.json，类型选Python，配置"request": "attach"+"port": 5678，再在代码开头加import debugpy; debugpy.listen(5678); debugpy.wait_for_client() - 注意：Dagger 0.12+ 默认禁用调试端口，得显式传
--debug，否则debugpy等不到连接
Dagger本地测试最耗时间的从来不是写代码，而是环境变量、Python解释器、CLI路径这三者没对齐——它们错一个，dagger run 就静默失败，连日志都不吐。
