pip install folium 即可安装，无需额外参数；但需确保在正确虚拟环境中执行，jupyter中安装后须重启内核才能导入，插件如heatmap已内置，无需[plugins]变体。

pip install folium 就够了，不需要额外参数或变体。

---

安装命令本身没坑，但环境常出问题

• 如果你用的是虚拟环境（比如 venv 或 conda），得先激活它，再运行 pip install folium
• 在 Jupyter Notebook 里直接跑 !pip install folium 也能装，但装完要重启 kernel 才能 import folium 成功
• Windows 上如果提示 pip is not recognized，说明 Python 的 Scripts 目录没进系统 PATH，不是 folium 的问题
• macOS 或 Linux 下用 sudo pip install folium 是危险操作，优先用 pip install --user folium

---

想装带插件的完整版？别用 pip install folium[plugins]

这个语法在 folium 0.20.0（当前最新稳定版）里已失效：

Ai Podcast Pipeline

从QuickView趋势笔记生成韩语AI播客包，含双人主持脚本（Callie×Nick）、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版（15~20分钟）和压缩版（5~7分钟）。

下载

• 插件如 HeatMap、MarkerCluster 现在都内置在主包里，无需额外安装
• folium[plugins] 这种写法只在非常老的版本（
• 真要用 HeatMap，直接 from folium.plugins import HeatMap 即可，前提是 folium 已装好

---

装完 import 不成功？先查三件事

• 运行 python -c "import folium; print(folium.<strong>version</strong>)"，确认输出是类似 0.20.0 的版本号
• 检查是不是在多个 Python 环境间跳来跳去，比如 VS Code 默认解释器和终端用的不是同一个
• import folium 报 ModuleNotFoundError 但 pip list | grep folium 显示已安装 → 八成是 pip 和 python 指向不同环境

folium 本身不依赖编译，纯 Python + 前端资源，所以“装不上”几乎从来不是它自己的锅，而是环境错位。