PYTHONSTARTUP指向旧版Python扩展路径致文件找不到问题排查

1. 确认VS Code终端的环境变量状态 #

• 在VS Code终端执行：
  • Linux/macOS: echo $PYTHONSTARTUP 确认变量指向的旧路径，再用env列出所有环境变量，排查关联的VS Code相关变量
  • Windows: echo %PYTHONSTARTUP% 确认路径，再用set查看全量环境变量
• 对比系统原生终端的环境变量，确认差异仅出现在VS Code环境中

2. 检查VS Code Python扩展的配置项 #

• 打开VS Code设置（快捷键Ctrl+,/Cmd+,），搜索python.startupScript，查看用户配置和工作区配置中是否手动指定了旧版本扩展的路径（工作区配置优先级更高）
• 若存在该配置，直接修改为2024.4.1版本的对应文件路径，或清空让扩展自动配置

3. 排查VS Code终端的自定义环境配置 #

• 在VS Code设置中搜索terminal.integrated.env.*（对应你的系统：linux/windows/osx），检查是否在该配置中手动设置了PYTHONSTARTUP变量
• 查看terminal.integrated.shellArgs.*配置，确认是否加载了外部脚本，导致该变量被覆盖

4. 清理VS Code扩展的更新残留 #

• 打开VS Code扩展安装目录：
  • Windows: %USERPROFILE%\.vscode\extensions
  • macOS/Linux: ~/.vscode/extensions
• 删除残留的2024.4.0版本扩展文件夹，同时检查是否有自动生成的配置文件（如扩展的缓存文件）指向旧路径
• 通过命令面板（Ctrl+Shift+P/Cmd+Shift+P）执行Python: Show Log，查找日志中关于PYTHONSTARTUP的配置记录，定位设置来源

5. 检查终端初始化脚本的隐藏配置 #

• 虽然登录Shell未设置，但VS Code终端可能加载了额外脚本：
  • Linux/macOS: 检查~/.bash_profile、~/.zprofile、~/.bashrc.d/、~/.zshrc.d/等目录下的脚本
  • Windows: 检查PowerShell的$PROFILE配置文件，以及%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup中的启动脚本

6. 重置Python扩展配置 #

• 若以上排查无结果，打开VS Code的设置JSON文件（命令面板执行Preferences: Open Settings (JSON)），删除所有包含python.startupScript或PYTHONSTARTUP的配置项
• 卸载Python扩展，重启VS Code后重新安装2024.4.1版本，让扩展自动生成正确的启动脚本路径

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