vscode选解释器时必须填虚拟环境内python可执行文件的完整相对路径：windows为./.venv/scripts/python.exe，macos/linux为./.venv/bin/python；路径不能含空格或中文，且需写入工作区.vscode/settings.json中python.defaultinterpreterpath字段，改后须重启vscode，并单独配置jupyter kernel路径。
VSCode选解释器时该填什么路径？
VSCode只认虚拟环境里的python可执行文件本身，不是文件夹、不是activate脚本、也不是软链接或符号链接。路径必须是相对于工作区根目录的相对路径，且必须精确指向二进制文件：
- Windows：
./.venv/Scripts/python.exe（不是activate.bat，不是python软链接） - macOS/Linux：
./.venv/bin/python（不是activate，不是python3符号链接） - 如果用
venv而非.venv，对应路径为./venv/Scripts/python.exe或./venv/bin/python - 路径里不能含空格或中文，否则Pylance可能解析失败；建议统一用
.venv，Git和VSCode默认忽略它
为什么选对了路径，补全还是不准、报ModuleNotFoundError？
常见原因不是路径错，而是VSCode缓存或配置没同步生效：
python-docx
下载
python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能，主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践；生成安全服务方案文档；核心要点生成技术架构设计文档；生成任何需要专业排版的Word文档；核心库 : python-docx；使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns；标准代码模板；1. 文档初始化；2. 字体设置（必须！它将相关步骤、工具调用和结果整理方式集
-
python.defaultInterpreterPath必须写入当前工作区的.vscode/settings.json，而不是用户级设置——用户级设置会覆盖项目级配置 - Pylance类型信息有强缓存，改完解释器后必须重启VSCode，否则补全、跳转、类型提示仍基于旧环境
- 状态栏显示
Python 3.x ('.venv': venv)只是UI提示，不等于真实生效；验证唯一可靠方式是运行import sys; print(sys.executable)，输出必须含.venv - 如果项目在WSL中创建但VSCode运行在Windows端，
./.venv/bin/python无法直接访问，需用\wsl$Ubuntuhomeuserproject.venvinpython这类wsl$前缀路径
终端里pip install还是装到全局？
选了解释器 ≠ 终端自动激活环境。VSCode集成终端默认不运行activate脚本，所以pip install默认仍走系统Python：
- 必须设
python.terminal.activateEnvironment为true（默认是true，但容易被用户级设置覆盖） - Windows PowerShell用户额外注意：
python.terminal.launchArgs若被设为["-NoExit", "-Command", ""]，会清空激活逻辑，建议清空该项 - 验证方法：新开终端后，提示符前应出现
(.venv)前缀；若没有，说明没激活成功，此时which python或where python仍指向系统路径
Jupyter Notebook kernel要单独配
VSCode里编辑器解释器和Notebook kernel是两套独立配置，互不影响：
- 右上角kernel下拉菜单必须手动选匹配的
.venv环境，不能依赖编辑器解释器选择结果 - kernel列表里显示的
Python 3.x (venv)名称不可信，点击“Change kernel”后点“Existing”再选路径，确认最终路径指向.venv/bin/python或.venv/Scripts/python.exe - kernel启动失败常见原因是
ipykernel没装在目标venv里——得在激活该venv的终端里运行pip install ipykernel，再执行python -m ipykernel install --user --name myproj --display-name "Python (myproj)"
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
