You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Mac系统VSCode终端Python版本异常 无法执行Django runserver命令求助

问题根因说明

这不是VSCode本身的故障,属于Mac系统工具缺失和VSCode Python解释器配置错误的双重问题,所有报错的关联性如下:

  • ) from exc语法报错:Django代码仅支持Python3运行,该语法是Python3独有的异常链式声明语法,Python2.7无法识别,完全由调用Python版本错误直接导致。
  • 不同终端Python版本不一致:Mac自带终端启动时会默认加载用户目录下的Shell配置文件(.zshrc/.bash_profile),你大概率在配置中设置了alias python=python3的别名,而VSCode内置终端默认没有以登录Shell模式启动,不会加载该别名配置,因此调用的是系统默认的Python2.7版本。
  • python3命令报xcrun错误:Mac系统默认绑定的Python3依赖Xcode命令行工具,该工具丢失后就会触发此报错。
分步解决步骤
  • 修复Xcode命令行工具缺失:打开Mac自带终端,执行命令xcode-select --install,按照弹窗提示完成工具安装,安装完成后执行xcode-select -p,确认输出为/Library/Developer/CommandLineTools即修复完成。
  • 配置VSCode项目默认解释器:进入你的Django项目,按下快捷键Command + Shift + P调出命令面板,搜索并选择Python: Select Interpreter,在下拉列表中选中你搭建的web_programming虚拟环境对应的Python3.9版本。
  • 调整VSCode终端启动配置:打开VSCode设置页面,搜索Terminal > Integrated: Shell Args,找到macOS系统对应Shell(默认为zsh)的配置项,添加参数-l,使内置终端启动时自动加载用户Shell配置。
  • 验证修复效果:重启VSCode内置终端,确认终端前缀仍带有(web_programming)的虚拟环境激活标识,执行python --version确认输出为Python3.9,再运行python manage.py runserver即可正常启动服务。

内容的提问来源于stack exchange,提问作者johnwow

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 20:36:03