python 3.8+是使用pandas的最低要求，推荐pyenv管理版本并升级pip；避免sudo安装，确保jupyter kernel与pandas环境一致；读中文路径需用原始字符串或正斜杠，编码选gbk或utf-8-sig；显示截断可通过display配置调整。
用 pandas 前必须装对 Python 版本和包管理器
Python 3.8 是当前最稳妥的起点，pandas 从 2.0 开始已不支持 Python 3.7 及更早版本。别直接用系统自带的 Python（尤其是 macOS），它常被系统依赖绑定，升级或装包容易出错。
- 推荐用
pyenv管理 Python 版本，装完后执行pyenv install 3.11.9 && pyenv global 3.11.9 -
pip必须是最新版：运行python -m pip install --upgrade pip，旧版pip在安装pandas时可能静默跳过编译优化，导致后续.groupby()或.merge()性能差一倍以上 - 避免用
sudo pip install pandas——这会污染系统 Python，后续 Jupyter 启动报ModuleNotFoundError: No module named 'pandas'就是典型症状
Jupyter Notebook 启动后找不到 pandas 怎么办
不是没装，而是 Jupyter 用的 kernel 和你装 pandas 的环境不一致。常见于用 conda 装了包，但 Jupyter 是用 pip 安装的，或者反之。
- 先确认当前 kernel 名：在 notebook 里运行
import sys; print(sys.executable)，输出路径应和你激活的环境一致 - 如果不对，用
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"注册正确环境 - Windows 用户注意：PowerShell 默认禁用脚本执行，运行上述命令前需先执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - Mac M1/M2 芯片用户若遇到
numpy报错，别硬装，直接用pip install --no-binary numpy pandas让它本地编译
pandas.read_csv() 读中文路径或含空格文件失败
Windows 下最常见，错误信息通常是 FileNotFoundError: [Errno 2] No such file or directory: '数据文件.csv'，其实文件明明存在——根本原因是 Python 3.8+ 对非 ASCII 路径默认编码处理变严格了。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 不要写
pd.read_csv('C:\用户\张三\数据.csv')，反斜杠会被当转义符；改用原始字符串：pd.read_csv(r'C:\用户\张三\数据.csv')或正斜杠：pd.read_csv('C:/用户/张三/数据.csv') - 含空格路径不用额外引号，但确保整个字符串是合法路径字面量，比如
'./my data/file.csv'是 OK 的，'./my data'/file.csv就语法错误 - 如果仍报错，加参数
encoding='gbk'（国产 Excel 导出 CSV 常用）或encoding='utf-8-sig'（带 BOM 的 UTF-8）
为什么 df.head() 显示不全、列名被截断
这是 Jupyter 自动调用 __repr__ 时的默认行为，不是数据丢了。Jupyter 为避免渲染过长内容卡死，会主动压缩显示宽度和行数。
- 临时展开：在 notebook 单元格开头加
%config pd.options.display.max_columns = None和%config pd.options.display.max_rows = 20 - 永久生效：在 Python 启动时执行，例如在 Jupyter 的
~/.ipython/profile_default/startup/00-init.py里写入配置 - 注意
max_colwidth默认是 50，中文字段超长会被截成“数据分析…”，可设为100或None（但太大会撑爆页面） - 别在生产脚本里用这些 display 配置——它们只影响交互式环境，脚本里 print(df) 不受其控制
真正麻烦的是混合编码的 CSV 和跨平台路径拼接，这两个地方出问题时，错误信息往往不指向根源，得靠 sys.executable 和 repr(path) 一层层验。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
