PyCharm远程调试需专业版、SSH权限及远程Python环境；配置SSH解释器并映射本地/远程路径，启用自动同步，断点调试实际在服务器运行。
Remote-SSH连接后找不到Python解释器
远程连接成功不代表Python环境就绪。VS Code默认只识别python3在$PATH中的位置，但很多Linux服务器（尤其是最小化安装）只有python软链接指向python3，而VS Code的Python扩展不自动跟随该链接。
常见错误现象：Python: Select Interpreter命令弹出的列表为空，或只显示Use python from PATH但点击后报错Command 'python' not found。
- 先在VS Code集成终端中运行
which python3确认路径（通常是/usr/bin/python3或/usr/local/bin/python3） - 如果
python命令不可用，手动创建软链接：sudo ln -s /usr/bin/python3 /usr/bin/python - 重启VS Code窗口（不是仅重载窗口），否则Python扩展不会重新扫描
- 若仍无效，在远程服务器上执行
python3 -m pip install --upgrade pip，确保pip可用——这是Python扩展探测环境的前提
为项目创建并自动激活虚拟环境
远程开发时直接用系统Python风险很高：不同项目依赖冲突、权限问题、升级破坏全局环境。必须为每个项目单独建.venv，且让VS Code自动识别它。
关键点在于路径和命名：VS Code只自动识别根目录下名为.venv、venv、.virtualenv或env的文件夹，且该文件夹必须由python3 -m venv创建，不能是conda或virtualenvwrapper生成的。
立即学习“Python免费学习笔记（深入）”；
- 在VS Code集成终端中进入项目根目录，运行：
python3 -m venv .venv - 等待创建完成（几秒），不要手动激活——VS Code会在下次打开文件夹时自动检测
- 打开一个
.py文件，底部状态栏应显示Python 3.x.x (.venv)，若显示灰色或无反应，按Ctrl+Shift+P→Python: Select Interpreter，手动选择.venv/bin/python - 验证是否生效：在
.py文件中写import sys; print(sys.prefix)，运行后输出路径应包含.venv
远程环境下pip install失败或超时
远程服务器常位于内网或受限网络，直接pip install会因DNS解析失败、源不可达或SSL证书问题卡住，错误信息通常是Could not fetch URL或Connection timed out。
这不是VS Code的问题，而是pip在远程机器上的网络配置缺失。本地改镜像源对远程无效，必须在服务器端操作。
- 先确认服务器能否访问外网：
curl -I https://pypi.org，若失败需联系运维开通出口或配置代理 - 临时换国内源（推荐清华源）：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ requests - 永久配置（避免每次输参数）：在远程服务器上创建
~/.pip/pip.conf（Linux）或%APPDATA%\pip\pip.ini（Windows Subsystem for Linux），写入：[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple/ trusted-host = pypi.tuna.tsinghua.edu.cn
- 如遇SSL错误（
SSLError: certificate verify failed），优先升级pip：python3 -m pip install --upgrade pip；若仍失败，加--trusted-host pypi.tuna.tsinghua.edu.cn参数临时绕过
调试时断点不命中或ModuleNotFoundError
远程调试失败最常见的原因是解释器路径和工作目录不一致。VS Code调试器启动时默认以当前打开的文件所在目录为cwd，但如果你的launch.json没显式指定，而项目结构复杂（比如有src/子目录），就会找不到模块。
例如：项目结构为project_root/src/main.py，你在src/里打开main.py并F5，调试器却以src/为根目录运行，导致import mypackage失败。
- 务必在项目根目录（含
.vscode/的同级）下打开文件夹，而不是只打开某个子文件 - 检查
.vscode/launch.json中的"cwd"字段，设为"${workspaceFolder}"（不是${fileDirname}） - 如果必须从子目录启动，用
"env": {"PYTHONPATH": "${workspaceFolder}"}注入路径 - 断点不命中？确认右下角Python解释器显示的是
.venv路径，而非系统Python；同时检查launch.json中"python"字段是否指向.venv/bin/python
cwd和PYTHONPATH这两个隐性变量——它们不报错，只默默让导入失败或断点失效。每次新建项目，先花30秒检查这两项，比反复重启调试器高效得多。 
