核心是选对解释器、配齐Pylance/Ruff等语言服务器与插件，并确保三者路径一致；需用pyenv+venv管理环境，安装Python官方扩展及python-lsp-server，验证os.补全生效即LSP就绪。
在 macos 上配置支持代码智能提示的 python 开发环境，核心是选对编辑器、装好 python 解释器、配齐语言服务器和补全插件。关键不在于堆砌工具，而在于让 python 解释器、lsp（语言服务器协议）和编辑器三者正确通信。
选一个支持 LSP 的现代编辑器
VS Code 是目前 macOS 上最轻量又最成熟的方案，免费、原生支持 Python 扩展生态，且调试、终端、Git 集成开箱即用。PyCharm 功能更全但较重；Sublime Text 或 Vim 需手动配置 LSP 客户端，容易卡在路径或 Python 环境识别上。
- 推荐直接下载 VS Code 官方版（code.visualstudio.com），不要用 Homebrew Cask 安装的旧版本
- 安装后打开命令面板（Cmd+Shift+P），输入 “Shell Command: Install ‘code’ command in PATH”，运行一次，后续就能在终端用
code .打开项目
配置 Python 解释器与虚拟环境
智能提示依赖解释器提供类型信息和模块结构。直接用系统 Python（/usr/bin/python3）会受限于权限和包管理混乱，必须使用独立环境。
- 用
pyenv管理多个 Python 版本：终端执行brew install pyenv && pyenv install 3.12.4 && pyenv global 3.12.4 - 项目级用
venv创建隔离环境：python -m venv .venv，然后在 VS Code 中按 Cmd+Shift+P → Python: Select Interpreter，选中.venv/bin/python - 确保已安装
pip install python-lsp-server[all]（不是python-language-server，后者已停更）
启用并验证 Pylsp / Ruff / Ruff LSP
VS Code 的 Python 扩展默认使用 Pylsp（即 python-lsp-server）作为语言服务器，它支持类型推断、跳转定义、实时错误检查和基础补全。如需更强的格式化与 lint 提示，可叠加 Ruff。
- 在 VS Code 中安装官方扩展 “Python”（Microsoft 出品，ID：
ms-python.python） - 打开设置（Cmd+, ），搜索 “python.defaultInterpreterPath”，确认指向你的
.venv/bin/python - 新建
test.py，输入import os; os.，稍等 1–2 秒，应弹出完整方法列表（如os.path、os.listdir）——出现即表示 LSP 已就绪 - 可选增强：安装 Ruff 扩展（
charliermarsh.ruff-vscode），并在设置中开启"ruff.enable": true，获得更快的语法检查与自动修复
常见失效场景与快速自查
90% 的“没提示”问题出在路径或环境错位，而非插件本身。
立即学习“Python免费学习笔记（深入）”；
- VS Code 终端里运行
which python和编辑器右下角显示的 interpreter 是否一致？不一致说明没选对解释器 - 在
.venv激活状态下运行python -c "import pylsp; print(pylsp.__version__)"，报错说明python-lsp-server未装进当前环境 - 关闭所有 VS Code 窗口，删掉
~/Library/Caches/vscode/下相关缓存（尤其ms-python.python文件夹），重启再试 - 如果用 M1/M2 Mac，避免混用 Intel 和 ARM 版本的 Python 或 pip 包（例如通过 Rosetta 启动 VS Code 会导致架构不匹配）
