根本原因是vscode集成终端与调试/运行时使用的python解释器环境不一致；需通过命令面板选择正确解释器、确认右下角路径一致、在终端执行which/where python验证路径，并用python -m pip install -r requirements.txt强制安装到目标环境。
VSCode里pip install -r requirements.txt不生效，根本原因是什么
不是命令写错了，而是终端用的Python环境和VSCode调试/运行时用的解释器不一致。你pip install -r requirements.txt在集成终端里跑成功了，但右下角状态栏显示的解释器路径却是/usr/bin/python3或另一个.venv，那import时照样报ModuleNotFoundError。
- 先按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，选中项目根目录下的.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows） - 确认右下角状态栏显示的路径和你刚选的一致；如果不一致，点它手动切换
- 打开集成终端（
Ctrl+`），执行which python（macOS/Linux）或where python（Windows），输出必须和状态栏路径完全一致 - 如果终端里
python -m pip list看不到你刚装的包，说明pip install装到了别的环境里——这时候必须用python -m pip install -r requirements.txt，强制走当前解释器的pip
生成requirements.txt时，pip freeze为什么不能直接用
pip freeze > requirements.txt会把所有包都倒出来，包括pip、setuptools、wheel，甚至pylint或black这类开发依赖，导致部署时安装一堆无用甚至冲突的包。
TikTok Creator Pipeline
下载
TikHub API 多平台数据爬取工具，支持抖音/TikTok/B站等。用户提及以下需求时调用：1) 爬取视频或评论；2) 获取用户信息/粉丝列表；3) 批量下载无水印视频；4) 抖音链接转文字（下载→音频→Whisper pipeline）；5) 调用 TikHubAPI。
- 生产项目优先用
pipreqs：先pip install pipreqs，再在项目根目录运行pipreqs . --force，它只扫描import语句，生成最小依赖集 - 如果有
setup.py或pyproject.toml，用pip-tools更稳妥：pip install pip-tools，写好requirements.in（只写顶层依赖，如requests、numpy），再运行pip-compile requirements.in - 生成后检查版本号：带
==的是锁定版（如requests==2.31.0），适合CI/CD；不带版本（如requests）会导致每次构建拉最新版，容易引入breaking change
requirements.txt里写版本号，该用==、>=还是~=`
不同符号影响部署稳定性，选错一个就可能让CI失败或线上崩溃。
-
==：精确锁定，适合生产环境，但升级需手动改；例如django==4.2.12 -
>=：允许小版本和补丁升级，但可能意外升到不兼容的大版本；例如requests>=2.28.0→ 可能装上3.0.0（如果存在） -
~=：推荐用于多数依赖，意思是“兼容性升级”，等价于>=X.Y.Z, ==X.*；例如click~=8.1.0→ 允许8.1.x，但不会升到8.2.0或9.0.0 - 避免空格和注释混用：
requests ~= 2.31.0（有空格）在某些旧pip版本里会解析失败，应写成requests~=2.31.0
VSCode里右键“从requirements.txt安装”为啥有时没反应
这个功能只在VSCode识别出Python环境节点时才可用，且依赖底层Python扩展对项目结构的解析。很多情况下它根本找不到requirements.txt，或者环境节点没加载出来。
- 确保项目根目录下有
requirements.txt，且文件名全小写、无空格、无隐藏字符 - 关闭再重新打开文件夹（不是仅关闭窗口），让Python扩展重新扫描环境
- 如果
Python Environment节点在资源管理器里不显示，说明VSCode没检测到解释器——先完成Python: Select Interpreter步骤 - 更可靠的做法是：在集成终端里手动运行
python -m pip install -r requirements.txt，比右键菜单稳定得多
.vscode/settings.json里没配"python.defaultInterpreterPath"。一旦你换电脑、重装VSCode或共享项目给同事，这个配置丢失，所有环境隔离就失效了——它不像requirements.txt会被git提交，得手动补。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
