关键在于lsp、编辑器与解释器/编译器三者路径对齐、协议互通；python需pyenv+venv管理环境并正确指向.venv/bin/python，c/c++依赖c_cpp_properties.json或compile_commands.json，js/ts须有tsconfig.json/jsconfig.json且node版本一致。
在 macos 上让代码分析（补全、跳转、错误检查、类型提示）真正生效，关键不是装一堆插件，而是让语言服务器（lsp）、编辑器和项目所用解释器/编译器三者路径对齐、协议互通。不同语言侧重点不同，但底层逻辑一致。
Python：Pylsp + Ruff + 正确解释器路径
智能提示失效 90% 源于解释器选错或 LSP 找不到包。必须用 pyenv + venv 管理环境，禁用系统 Python（/usr/bin/python3）。
- 终端执行：
brew install pyenv && pyenv install 3.12.4 && pyenv global 3.12.4；项目根目录运行：python -m venv .venv - VS Code 中按 Cmd+Shift+P → Python: Select Interpreter，手动指向
.venv/bin/python - 安装官方 Python 扩展（ms-python.python），它默认启用
python-lsp-server（即 Pylsp） - 验证：新建
test.py，输入import os; os.，等 1–2 秒弹出完整方法列表即成功 - 增强 lint 与格式化：装 Ruff 扩展（charliermarsh.ruff-vscode），设置中开启
"ruff.enable": true
C/C++：Clangd 或 Microsoft C/C++ 扩展 + 正确 compile_commands.json
macOS 自带 Clang，但 VS Code 默认的 Microsoft C/C++ 扩展依赖 c_cpp_properties.json 或 compile_commands.json 获取头文件路径与宏定义，否则无法识别标准库或第三方头文件。
- 先确保已装 Xcode 命令行工具：
xcode-select --install，验证：clang++ --version - 推荐使用 C/C++ 扩展（ms-vscode.cpptools），而非 Clangd（配置更复杂）
- 项目根目录建
.vscode/c_cpp_properties.json，填入：{ "configurations": [{ "name": "Mac", "includePath": ["/usr/include/**", "/usr/local/include/**", "${workspaceFolder}/**"], "compilerPath": "/usr/bin/clang" }] } - 简单项目可省略
c_cpp_properties.json，靠tasks.json编译时自动生成compile_commands.json（需 CMake 项目）
JavaScript/TypeScript：TS Server 内置，但需注意 Node 版本与 workspace 配置
VS Code 对 JS/TS 支持开箱即用，但大型项目常因 Node 版本不一致或 jsconfig.json/tsconfig.json 缺失导致路径跳转失败、模块解析错误。
- 用
nvm或fnm管理 Node 版本，避免 Homebrew 全局安装导致项目间冲突 - 项目根目录必须有
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容为空对象{}，否则 TS Server 不激活项目级分析 - 检查 VS Code 右下角是否显示当前 TS 版本（如 “TypeScript 5.4”），点击可切换工作区版本，优先使用
node_modules/.bin/tsserver - 若 import 提示“Cannot find module”，确认
baseUrl和paths配置正确，且allowSyntheticDefaultImports开启
通用排查要点（所有语言都适用）
当补全/跳转/报错不工作，别急着重装插件，先查这四点：
- VS Code 终端里运行
which python/which clang++/which node，确认输出路径与编辑器设置中指定的一致 - 打开命令面板（Cmd+Shift+P），搜 “Developer: Toggle Developer Tools”，看 Console 是否有 LSP 连接失败或启动崩溃日志
- 检查项目根目录是否被 VS Code 正确识别为 workspace（左下角应显示文件夹名，而非 “No Folder Opened”）
- 关闭所有扩展，只留对应语言的官方扩展，再逐个启用，定位冲突源
