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
相关产品推荐
相关产品推荐

