VSCode本身不运行代码，需配置工具链和扩展；Mac上常见失败因PATH未通、code-runner默认用python而非python3、GUI不加载shell配置，应改~/.zprofile加PATH并重启VSCode。
Mac 上 VSCode 不能直接“运行代码”，它本身不带编译器或解释器——你得先配好对应语言的工具链，再靠插件或手动命令触发执行。否则点 Run Code 只会报错、卡住，或者输出一堆找不到 gcc / python 的提示。
为什么 code . 能打开项目，但 Ctrl+F5 或右键 Run Code 却失败
这是最常被忽略的前提问题：VSCode 不是 IDE，它默认不绑定任何执行逻辑。所谓“运行”，其实是靠扩展（如 Code Runner）调用系统已安装的命令完成的。如果终端里都跑不通 gcc --version 或 python3 --version，那 VSCode 也无能为力。
- 检查终端是否真能执行目标命令：
gcc --version、python3 --version、node --version—— 不是python，Mac 系统自带的 Python 2.7 已弃用，必须明确用python3 -
Code Runner默认使用python命令，而 Homebrew 安装的 Python 是python3，不改配置就一定报command not found - 如果刚装完 Xcode Command Line Tools，需重启 VSCode 才能刷新 PATH；GUI 应用不会自动读取
~/.zshrc，要写进~/.zprofile
Code Runner 插件怎么配才不踩坑
Code Runner 是 Mac 上最轻量的“一键运行”方案，但它默认配置对 macOS 很不友好，尤其 Python 和 C/C++ 场景。
- 安装后务必进设置（右键插件 → Extension Settings），修改
code-runner.executorMap： - Python 改成：
"python": "python3 -u",（加-u避免输出缓冲导致看不到实时日志） - C 改成：
"c": "cd $dir && gcc $fileName -o $fileNameWithoutExt && ./$fileNameWithoutExt",（别用默认的gcc单步，它不链接也不执行） - 勾选
code-runner.runInTerminal：否则输出在 Output 面板里，没法交互输入 - 取消勾选
code-runner.preserveFocus：不然每次运行完光标还留在编辑器，没法立刻敲下一行命令
C/C++ 项目必须配 c_cpp_properties.json 吗
不是“必须”，但不配就等于放弃智能提示、跳转、头文件识别——#include <stdio.h> 报红、printf 没提示、Ctrl+Click 进不去源码，全是因为 IntelliSense 找不到系统头文件路径。
- 首次打开
.c或.cpp文件时，报错提示右下角有 Quick Fix，点它选Use clang in /usr/bin，VSCode 会自动生成.vscode/c_cpp_properties.json - 自动生成的配置里
compilerPath是/usr/bin/clang，这没问题；但如果你用 Homebrew 装了gcc-13，就得手动改成/opt/homebrew/bin/gcc-13，否则提示和实际编译器不一致 -
includePath必须包含 SDK 路径，比如：/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include，缺了它，<sys/socket.h>这类系统头就标红
终端里能跑，VSCode 集成终端却提示 command not found
这是 macOS 特有的 PATH 传递问题：GUI 应用（包括 VSCode）启动时，不加载 shell 的 profile/rc 文件，所以 brew install 的路径（如 /opt/homebrew/bin）根本不在 VSCode 的环境变量里。
- 不要改
~/.zshrc，它只对终端生效；要改~/.zprofile（macOS 10.15+ 推荐方式） - 往
~/.zprofile里加：export PATH="/opt/homebrew/bin:$PATH"（Homebrew ARM64 默认路径）或export PATH="/usr/local/bin:$PATH"（Intel 或旧版 Homebrew） - 改完后必须彻底退出 VSCode（菜单栏 → Quit Visual Studio Code），再重新打开，不能只是 Reload Window
- 验证方法：VSCode 里按
Cmd+Shift+P→Developer: Toggle Developer Tools→ Console 标签页 → 输入process.env.PATH，看输出是否含你期望的路径
真正卡住人的从来不是“怎么点运行”，而是 PATH 没通、编译器没装、插件用默认配置硬扛 macOS 差异。把终端能跑通作为第一道门槛，再让 VSCode “看见”这个环境，后面所有操作才有意义。
