Mac下PyCharm无法连接Docker:提示Docker守护进程未运行
问题原因分析
在macOS上,Docker Desktop默认不会在/var/run/目录下创建docker.sock文件——这个路径是Linux系统中Docker daemon的默认socket位置,而macOS上的Docker实际运行在后台虚拟机里,其真实socket路径为~/Library/Containers/com.docker.docker/Data/docker.sock。
你的PyCharm 2021.2.3版本可能默认配置了Linux风格的socket路径,之前能正常工作大概率是因为曾存在临时软链接、Docker Desktop旧版本的兼容设置,或是PyCharm配置被自动适配过,但后续系统/应用更新后这些适配逻辑失效了。
解决方案(无需sudo权限)
修改PyCharm的Docker连接路径
- 打开PyCharm的
Settings/Preferences→Build, Execution, Deployment→Docker - 找到当前的Docker连接配置,将
Unix socket的路径替换为~/Library/Containers/com.docker.docker/Data/docker.sock - 点击
Test Connection验证是否能正常连接
- 打开PyCharm的
使用Docker Context连接
- 在终端执行
docker context list,查看可用的context(通常会有desktop-linux或desktop-mac) - 在PyCharm的Docker配置页面,选择
Docker Context选项,输入对应的context名称(比如desktop-mac) - 测试连接确认有效性
- 在终端执行
检查Docker Desktop设置
- 打开Docker Desktop →
Settings→Advanced - 确认是否开启了"Allow the default Docker socket to be used"相关选项(部分版本可能叫"Expose daemon on tcp://localhost:2375 without TLS"),如果开启,也可以在PyCharm中选择
TCP socket,填入tcp://localhost:2375进行连接
- 打开Docker Desktop →
版本兼容尝试
你的PyCharm版本(2021.2.3)发布于2021年,而macOS Ventura 13.1是2022年底的系统,存在一定版本跨度。如果上述方法无效,可尝试升级PyCharm到较新的社区版(如2022.3及以上),新版本对macOS Ventura的Docker适配更好。
内容的提问来源于stack exchange,提问作者W.P. McNeill
相关产品推荐
相关产品推荐

