在 VSCode 中编写 Python 代码时遇到的常见问题与解决方案

帖子回复：

在VSCode里写Python，有几个坑我踩过，分享一下我的经验。

1. 环境/解释器问题 最常见的就是VSCode没选对Python解释器。右下角状态栏点一下Python版本，选对虚拟环境或者系统解释器。如果列表是空的，检查Python扩展装没装，或者路径对不对。

2. 导入模块报错 (ImportError) 这通常是因为工作目录或者PYTHONPATH不对。有几种搞法：

• 在.vscode/settings.json里设置"python.terminal.executeInFileDir": true，让终端在当前文件目录跑。
• 用相对导入时，确保文件在正确的包结构里（有__init__.py）。
• 对于项目依赖，老实点，在项目根目录用pip install -r requirements.txt。

3. 调试器不工作 确保launch.json配置对了。一个基础的运行当前文件的配置长这样：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true
        }
    ]
}

断点打在可执行行上，别打在空行或者注释上。

4. 代码提示/智能感知 (IntelliSense) 太慢或失效

• 先等语言服务器加载完，尤其是刚打开项目时。
• 检查打开的文件夹是不是太大了，可以加个.vscode/settings.json排除无关文件："files.exclude": { "**/__pycache__": true, "**/.git": true }。
• 实在不行，命令面板里运行Python: Restart Language Server重启一下。

5. 格式化工具 (如 black, autopep8) 不按预期工作 首先确保工具装在了当前选择的解释器环境里。然后在settings.json里指定：

{
    "python.formatting.provider": "black",
    "[python]": {
        "editor.defaultFormatter": "ms-python.python",
        "editor.formatOnSave": true
    }
}

editor.formatOnSave设成true能保存时自动格式化。

6. 终端行为异常（比如在错误目录激活） 前面提过的"python.terminal.executeInFileDir": true能解决大部分问题。如果用的是PowerShell，可能还需要配置默认的Shell配置文件。

7. 测试发现器找不到测试 (pytest/unittest) 对于pytest，在settings.json里加：

{
    "python.testing.pytestEnabled": true,
    "python.testing.unittestEnabled": false,
    "python.testing.cwd": "${workspaceFolder}",
    "python.testing.pytestArgs": ["."]
}

确保测试文件命名符合规范（test_*.py 或 *_test.py），测试类/函数也以test开头。

总结一下： 大部分问题出在环境配置、路径或者扩展设置上，对着这几个地方查一般能解决。

如果你是同时写多个项目，一个项目一个独立的 python 环境，你就知道 vscode 多难用了。

除了 说的在点子上，其余全 JB 跑题

#10 #10
#1 #1 对 pyenv 挺友好的啊。
“python.pythonPath”: "/usr/local/opt/pyenv/shims/python"
在设置中这样设置，然后用 pyenv local project_directory xxx
无痛切换

不好用，我在 C 文件里 import 了 B，B 里面 import 了 A，用 vscode 在 C 文件里使用 A 里面的类，语法检测就会报错说这个类不存在。

题外话，vim 用 deoplete+jedi 大多数时候很正常，但有些 package （比如 beautifulsoup)会不能正常补全（基本上只有 constructor 能补全），有人遇到过吗？

应该不是这两个设置的问题

git.autorefresh=true
git.checkoutType=all

这两个都是默认设置