vscode中import失败90%源于解释器与pip环境不一致：需在集成终端执行which python（macos/linux）或where python（windows），再运行import sys; print(sys.executable)比对路径是否完全一致，不一致则必须通过ctrl+shift+p → python: select interpreter重新选择带完整路径的解释器。
确认当前解释器与pip是否指向同一Python环境
VSCode里装了库却import失败，90%是因为终端用的pip和代码运行时的Python不是同一个。Pylance、调试器、终端各自记一个路径，不一致就全乱套。
- 在集成终端里执行
which python（macOS/Linux）或where python（Windows），记下路径 - 在Python文件里加一行
import sys; print(sys.executable)，运行后对比输出 - 两者必须完全一致；不一致就立刻用
Ctrl+Shift+P→Python: Select Interpreter重新选 - 别信右下角只显示“Python 3.11”，一定要看到带完整路径的版本信息，比如
Python 3.11.5 ('venv': venv)
用pip install时避免跨环境误操作
右键“Run Python File”不会触发pip安装，它只是执行代码——这点很多人卡住半天。装库唯一可靠入口是集成终端（Ctrl+`），且必须确保该终端已激活目标环境。
百度文档解析pipeline-parser
下载
调用百度文档解析API，支持18+格式，提取文本、表格、版面分析、OCR识别及RAG文档分块。适用于文档解析、文本/表格提取、结构分析、扫描件处理。触发词：文档解析、PDF解析、Word解析、表格提取、OCR、文档分析、提取文本、文档结构、扫描识别。
- 终端启动后，先看提示符前是否有
(venv)或(myenv)；没有就说明没激活 - 不要用
sudo pip install，尤其在macOS上，这会污染系统Python，后续所有项目都可能崩 - 如果
pip --version显示的Python路径和python --version不同，说明pip不是当前解释器的，改用python -m pip install xxx - 装完后执行
pip list | grep requests（把requests换成你要查的包名）验证是否真装进去了
处理PyPI包名与导入名不一致的坑
Pylance报 Import "xxx" could not be resolved，常不是环境问题，而是你搞错了包的导入名。它不看pip install后面的名字，只认import语句里的字符串。
-
pip install python-dotenv→ 代码里写import dotenv，不是import python-dotenv -
pip install Pillow→ 必须写from PIL import Image，写import pillow或import PIL都会失败 -
pip install opencv-python→ 正确导入是import cv2，不是import opencv - 不确定时，查官方文档的“Usage”部分，或装完后进Python交互式环境试：
import xxx看是否报错
虚拟环境 + requirements.txt 是版本兼容性底线
靠全局Python或手动pip freeze凑requirements.txt，迟早出事。不同机器、不同时间点，pip install行为不可复现——尤其当依赖树里有间接依赖变动时。
- 项目根目录建
.venv后，用python -m venv .venv创建，再选中它作为解释器 - 装完所有库后，运行
pip freeze > requirements.txt，而不是手写或复制粘贴 - 别人拉代码后，先
python -m venv .venv，再pip install -r requirements.txt，跳过任何“我本地能跑”的侥幸 - requirements.txt 里避免写死次要版本号（如
requests==2.31.0），除非你明确需要那个版本；更推荐requests>=2.31.0, 或直接 <code>requests
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
