VSCode终端中Starship激活虚拟环境时重复显示venv名称的解决方法

原因 #

pipenv激活虚拟环境时会默认输出环境名称，而Starship已经在提示符里包含了虚拟环境标识，导致重复显示。这个问题只在VSCode终端出现，是因为VSCode终端的shell配置和原生终端有差异，触发了pipenv的额外输出。

解决办法 #

1. 让pipenv激活时不输出环境名称 #

打开~/.zshrc文件，添加一行：

export PIPENV_VERBOSITY=-1

保存后执行source ~/.zshrc生效。这个环境变量会压低pipenv的输出级别，直接屏蔽激活时的环境名称回显。

2. 调整Starship配置（可选） #

如果上面的方法没起作用，或者你想彻底避免重复，可以修改Starship的配置文件~/.config/starship.toml，调整虚拟环境模块的显示：

[python]
# 自定义虚拟环境的显示格式，或者直接禁用
virtualenv_format = "[$virtualenv] "
# 要是不需要Starship显示虚拟环境，就把下面这行注释打开
# disabled = true

改完后执行starship reload或者重启终端生效。

3. 调整VSCode终端的shell启动参数 #

VSCode终端默认的shell启动模式可能导致pipenv行为异常，你可以设置zsh以登录shell模式启动：

• 打开VSCode设置（按Cmd+,）
• 搜索terminal.integrated.defaultProfile.osx，确认默认终端是zsh
• 搜索terminal.integrated.shellArgs.osx，添加-l作为参数
• 或者直接在settings.json里加这段：

"terminal.integrated.shellArgs.osx": ["-l"]

验证 #

执行pipenv shell激活虚拟环境，检查是否只有带虚拟环境标识的Starship提示符，不再额外输出环境名称。

内容的提问来源于stack exchange，提问作者mentoc3000