VS Code 中 NumPy 和 Pandas 代码提示需三者对齐：正确 Python 解释器、启用 Pylance 语言服务器、安装 numpy-stubs/pandas-stubs；任一缺失均导致悬停无类型、点不出方法。
VSCode
避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。
下载
numpy 和
pandas 的代码提示在 VSCode 里不是“装了就能用”，而是依赖三个关键环节同时对齐：Python 解释器路径、Pylance 语言服务器状态、以及类型 stubs 是否就位。缺一不可，任一错位都会导致
pd.DataFrame() 悬停无类型、
np.array() 点不出方法。
确认当前 Python 解释器是否真装了 numpy/pandas
VSCode 右下角显示的解释器路径，必须和你运行
pip install numpy pandas 时所用的环境完全一致。常见错误是：
- VSCode 选的是
/usr/bin/python3，而你在终端里用的是 conda activate myenv 后装的包
-
which python 和 python -c "import sys; print(sys.executable)" 输出不一致
-
pip show pandas 在 VSCode 内置终端里报错，说明当前终端根本没连上目标环境
务必在 VSCode 内置终端（Terminal → New Terminal）中执行：
python -m pip install --upgrade pip
python -m pip install numpy pandas
而不是直接敲
pip install —— 这能强制走当前解释器绑定的 pip。
确保 Pylance 正在工作且设为默认语言服务器
Pylance 不是“开了插件就自动生效”。检查两处：
- 扩展面板中搜索
Pylance，确认状态为「已启用」
- 设置中搜索
python.languageServer，值必须是 Pylance（不是 Jedi 或 None）
- 如果右下角长期显示
Pylance is initializing…，删掉 ~/.vscode/extensions/ms-python.vscode-pylance-*/out 目录再重启 VSCode
Pylance 卡住时，连
print() 的参数提示都会消失，更别说
pd.read_csv() 的 keyword 参数了。
安装 pandas-stubs 和 numpy-stubs 补全结构化类型
原生
pandas 和
numpy 包不含完整类型注解，Pylance 需要额外 stubs 才能推断
DataFrame 列名、
Series.dtype 等。运行：
python -m pip install pandas-stubs numpy-stubs
然后重启 VSCode 窗口（不是仅重载窗口）。验证方式：打开一个含
import pandas as pd 的文件，把光标停在
pd 上，悬停应显示类似
Module 'pandas' (stub file) 的提示；点进
pd.DataFrame 应能看到带参数名和类型的签名。
为什么改完设置还是没提示？重点看这三处
真正卡住提示的，往往不是“没装”，而是：
-
.vscode/settings.json 里硬写了过期的 python.defaultInterpreterPath，优先级高于 GUI 选择
-
sys.path 里没有对应环境的 site-packages 路径（可用 python -c "import pandas; print(pandas.__file__)" 查证）
- 项目根目录下有
pyrightconfig.json 或 pyproject.toml 且配置了错误的 extraPaths，干扰了模块解析
这些地方比重装插件更值得先查。
