必须先执行sudo xcode-select --reset再运行xcode-select --install，因macos升级后命令行工具路径损坏；vscode需用code --new-window启动以继承新path，或手动配置terminal.integrated.env.osx。
这是 macOS 系统升级后最典型的环境断连问题，不是 VSCode 坏了，也不是 Git 或 C++ 编译器出错，而是系统把开发工具路径“弄丢了”——修复只需一行命令，但必须在正确时机执行。
执行 xcode-select --install 后没反应或弹窗失败
这不是命令错了，而是 Apple 的命令行工具安装机制在 2026 年已改用静默分发策略：终端输入后可能不弹窗，或弹出“找不到软件”提示。
- 先运行
xcode-select -p看当前路径，如果输出类似/Library/Developer/CommandLineTools但报错依旧，说明目录存在但内容损坏 - 强制重置路径：
sudo xcode-select --reset，再立刻运行xcode-select --install - 若仍失败，直接去 Apple Developer Downloads 手动下载最新版
Command Line Tools for Xcode 15.x（注意选匹配你 macOS 版本的，如 macOS 15 Sequoia 对应 15.4+） - 下载的是
.dmg，挂载后双击.pkg安装，不要拖拽复制
VSCode 里 git status 还是报错，但终端里正常
VSCode 启动时不会自动继承你 shell 配置里的环境变量，它用的是登录会话的初始 PATH，而 xcode-select --install 安装后的新工具路径可能没被 VSCode 读到。
- 关掉所有 VSCode 窗口（包括后台进程，用
ps aux | grep code确认无残留） - 不要从 Dock 或 Launchpad 启动，改用终端执行：
code --new-window - 如果仍不行，在 VSCode 设置里搜索
terminal.integrated.env.osx，添加："terminal.integrated.env.osx": { "PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Developer/CommandLineTools/usr/bin" } - 重启集成终端（Ctrl+Shift+`），再试
git status
code . 命令失效或提示“command not found”
这不是开发路径问题，而是 VSCode 的 shell 命令未正确注册到系统 PATH —— 尤其常见于通过官网 dmg 安装、非 Homebrew 安装的用户。
- 打开 VSCode，按 Cmd+Shift+P → 输入
Shell Command: Install 'code' command in PATH→ 回车执行 - 如果该命令不可见，说明 VSCode 没权限写入
/usr/local/bin；手动创建软链：sudo ln -sf "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" /usr/local/bin/code
- 验证：
which code应输出/usr/local/bin/code；code --version应返回版本号 - 注意：不要用
sudo code启动编辑器，否则后续插件安装会因权限错乱失败
真正容易被忽略的点是：macOS 升级后，/Library/Developer/CommandLineTools 目录可能残留旧版本符号链接，或 xcrun 缓存未刷新。执行完安装后，务必运行一次 xcode-select -p 和 xcrun --version 双重确认，而不是只看终端有没有报错。
