VS Code中Python开发需正确配置解释器、编辑器、环境变量和代码片段：①手动选择项目虚拟环境解释器；②启用自动换行、延迟保存和保存时格式化；③通过.env文件和launch.json注入环境变量；④为python语言ID精准配置snippets scope。
Python解释器选不对，智能提示和调试直接失效
VS Code不会自动把python命令指向你项目该用的那个环境——它只认系统默认或上次手动选过的解释器。一旦你用venv或conda新建了环境，但没在VS Code里显式切换，就会出现：函数跳转失败、import标红、断点不触发、甚至pip install装到错的地方。
实操建议：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，从列表里选带项目路径的环境（比如./venv/bin/python或~/miniconda3/envs/pi0_env/bin/python） - 确认状态栏右下角显示的是你期望的解释器路径，不是
System (Python 3.x) - 如果列表为空，先在终端激活环境后运行
which python（macOS/Linux）或where python（Windows），把输出路径粘贴进命令面板的“Enter interpreter path”选项
settings.json里这三行不配，代码写一半就崩溃
很多人只调字体缩进，却漏掉影响稳定性的底层配置。尤其在写长prompt、处理JSON响应、或调试LLM链路时，缺这几项会导致编辑卡顿、换行错乱、保存丢失。
实操建议：
-
"editor.wordWrap": "on"—— 否则1000字符的prompt全挤在一行，眼睛看花也找不到空格在哪 -
"files.autoSave": "afterDelay"和"files.autoSaveDelay": 1000—— 延迟1秒自动保存，避免频繁磁盘写入拖慢响应，又防Alt+Tab切窗口时忘存 -
"editor.formatOnSave": true—— 配合black或autopep8插件，保存即格式化，省得每次手动Shift+Alt+F
环境变量硬编码在代码里，上线就炸
os.environ["API_KEY"] = "sk-xxx" 这种写法本地能跑，CI/CD一构建就报KeyError，更别说密钥泄露风险。VS Code本身不加载.env，必须显式告诉它。
实操建议：
- 项目根目录建
.env文件，写OPENAI_API_KEY=sk-xxx这类键值对 - 装
Python扩展后，在.vscode/launch.json里加一行："envFile": "${workspaceFolder}/.env" - 调试时自动注入，但注意：仅
launch.json生效，终端集成终端（Integrated Terminal）默认不读.env，需额外装dotenv插件或手动source .env
代码片段（snippets）配错scope，补全永远不弹
你写了log想展开console.log()，结果毫无反应——大概率是scope字段填错了。VS Code按语言作用域匹配片段，javascript和typescript是两个不同scope，py根本不存在，得写python。
实操建议：
- 打开命令面板，输
Preferences: Configure User Snippets，选python生成python.json - 片段定义里
"scope": "python"必须小写、无空格、与语言ID严格一致（查语言ID：右下角状态栏点“Python”，弹出菜单里显示的就是ID） - 测试时，新建
test.py文件，输入前缀再按Tab；若无效，检查文件是否被识别为Plain Text（右下角显示错误语言名）
envFile只在调试时生效，python.defaultInterpreterPath只影响新终端，而editor.suggest.snippetsPreventQuickSuggestions设成false才能让片段和AI补全共存。这些边界条件不摸清，配一百次也白搭。 
