必须用 pip install ydata-profiling（短横线）安装，而非下划线或旧名；import失败需确认环境一致；内存不足时加 minimal=True 或禁用相关性分析；中文乱码须指定CSV编码；字段名含特殊字符需预处理；本地打开HTML会因安全策略失效，应启用http.server服务访问。
pip install ydata-profiling 失败或报错
常见错误是 pip install ydata-profiling 提示找不到包，或者安装后 import 报 ModuleNotFoundError: No module named 'ydata_profiling'。这是因为项目在 2023 年已正式更名为 ydata-profiling → ydata_profiling（下划线），但旧文档、缓存和部分镜像仍指向老名。
- 必须用
pip install ydata-profiling（短横线），不是ydata_profiling或pandas-profiling - 如果装完 import 还失败，检查是否在虚拟环境中：运行
which python或where python确认 pip 和 python 指向同一环境 - Windows 上若报
Microsoft Visual C++ 14.0 is required，直接装build-essential不行，应去微软官网下 Build Tools for Visual Studio，勾选“C++ build tools”
生成报告卡住或内存爆掉
ProfileReport(df) 在中等规模数据（比如 5 万行 × 50 列）上可能吃光 16GB 内存，甚至卡死不返回。这不是 bug，是默认开启全量统计（相关性矩阵、缺失模式热力图、文本长度分布等）导致的。
- 加
minimal=True参数可跳过大部分耗时计算：ProfileReport(df, minimal=True)，适合快速预览 - 对大表，优先设
samples=None（禁用抽样）+correlations=None（关掉所有相关性分析），这两项最吃内存 - 别在 Jupyter 里直接
report.to_notebook_iframe()渲染超大报告——先report.to_file("report.html")，再用浏览器打开
中文字段名/值乱码或显示异常
报告里字段名变成方块、中文值显示为 ，或排序错乱，基本是 pandas 读取 CSV 时没指定编码，导致 DataFrame 内部已是乱码，ydata-profiling 只是忠实渲染。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 读取前务必确认编码：用
pd.read_csv("data.csv", encoding="utf-8")；如果还不行，试gbk或用chardet检测：chardet.detect(open("data.csv","rb").read()) - 字段名含空格、括号、点号（如
user.name）会导致 JS 渲染异常，报告里字段消失或 JS 报错Uncaught SyntaxError—— 预处理重命名：df.columns = df.columns.str.replace(r'[^a-zA-Z0-9_]', '_', regex=True) - 时间列若被识别成 object 而非 datetime，会丢失时间分布图 —— 手动转：
df["date"] = pd.to_datetime(df["date"], errors="coerce")
导出 HTML 后交互失效或图表空白
双击打开本地 report.html 文件，发现按钮点不动、直方图不加载、缺失图是空框 —— 这是浏览器安全策略阻止了本地 JS 加载依赖资源（如 plotly 的 CDN 资源被拦截）。
立即学习“Python免费学习笔记（深入）”；
- 绝对不要双击 HTML 文件打开；必须用 HTTP 服务启动：
python -m http.server 8000，然后访问http://localhost:8000/report.html - 公司内网或离线环境无法连外网时，
ProfileReport(..., offline=True)会把 plotly 等 JS 库打包进 HTML，但体积增大 2–3MB，首次生成稍慢 - 导出 PDF（
report.to_file("r.pdf")）本质是调 Chrome headless 截图，需本地装 Chrome 或 Chromium；没装会静默失败，文件为空 —— 先运行chromium-browser --version或chrome --version确认存在
