核心是路径对齐：lsp、编辑器、解释器/编译器须指向同一工具链。python需pyenv+venv+手动选.venv/bin/python；c/c++需c_cpp_properties.json显式配置includepath和compilerpath；js/ts需node版本一致且存在tsconfig.json/jsconfig.json。
macos 下编程环境能正常工作，核心是路径对齐：语言服务器（lsp）、编辑器、项目所用解释器或编译器三者必须指向同一套工具链，且协议互通。路径错一位，补全、跳转、类型提示就可能失效。
Python：pyenv + venv + 正确 interpreter 路径
90% 的智能提示失败源于解释器选错。系统自带 /usr/bin/python3 受 SIP 保护，不可 pip 安装包，也找不到用户安装的库。
- 用
pyenv管理 Python 版本：执行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（不是.venv/bin/python3） - 确认 Pylsp（python-lsp-server）已启用：官方 Python 扩展默认开启，无需额外安装 LSP 服务端
C/C++：Clang 路径 + 头文件搜索路径显式声明
macOS 自带 Clang，但 VS Code 的 C/C++ 扩展（ms-vscode.cpptools）不会自动猜头文件位置，必须通过配置告知。
- 先确保命令行工具已装：
xcode-select --install，验证clang++ --version - 项目根目录建
.vscode/c_cpp_properties.json，关键字段填对：{ "configurations": [{ "name": "Mac", "includePath": ["/usr/include/**", "/opt/homebrew/include/**", "${workspaceFolder}/**"], "compilerPath": "/usr/bin/clang" }] } - Homebrew 安装的库（如 openssl、curl）头文件在
/opt/homebrew/include（Apple Silicon）或/usr/local/include（Intel），务必加入includePath
JavaScript / TypeScript：Node 版本一致 + tsconfig.json/jsconfig.json 存在
TS Server 是 VS Code 内置服务，但它启动依赖两个硬性条件：当前工作区有配置文件，且 Node 运行时与编辑器调用的是同一个。
- 用
fnm或nvm管理 Node 版本，避免全局brew install node导致多项目冲突 - 项目根目录必须存在
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容只是{} - 检查 VS Code 终端中
which node输出路径，应与fnm current或nvm current一致；不一致时重启 VS Code 或重载窗口
通用路径检查法：三步快速定位问题
当代码分析异常时，不要盲目重装插件，先做这三件事：
- 在 VS Code 终端中运行
which python/which clang/which node，确认输出路径与你配置的解释器/编译器路径完全一致 - 打开命令面板（
Cmd+Shift+P），搜 “Developer: Toggle Developer Tools”，看 Console 是否报 LSP 启动失败或连接超时 - 检查
~/.zshrc（默认 shell）中PATH设置是否把 Homebrew 路径（/opt/homebrew/bin或/usr/local/bin）放在最前，否则终端和编辑器可能调用不同二进制
