很多刚学Python的同学,还没开始写代码,就栽在环境配置上。
明明装好了Python,打开VSCode到处报错,网上教程五花八门,版本还过时,跟着做依旧踩坑。
今天保姆级带你从零搭好VSCode Python开发环境,全程照着做,避开90%的坑。
首先记住一个关键点:VSCode只是编辑器,它本身不带Python运行环境,必须先装Python本体。
第一步,安装Python。
Windows用户一定要注意,安装界面务必勾选【Add Python to PATH】,这一步漏掉,后面会报“python不是内部命令”。
安装路径不要带中文、空格。装完打开终端输入 python --version ,能输出版本号,就代表安装成功。
第二步,安装VSCode。
安装完成之后,不要着急写代码,先装两个必备插件。
第一个,微软官方的Python插件,语法提示、运行调试全靠它。
第二个,Code Runner,一键快速运行代码。
安装完记得重启VSCode,让插件生效。
接下来是最容易翻车的一步:选择解释器。
很多人代码写的没问题,运行就报错,就是解释器选错了。
看VSCode右下角,点击当前Python版本,在列表里选中你安装好的Python。
找不到的话,手动选择python.exe的路径。
这里重点提醒,做项目一定要用虚拟环境。
不同项目需要不同版本的库,虚拟环境可以隔离依赖,避免版本冲突。
快捷键Ctrl+Shift+P,输入Python: Create Environment,选择venv,一键创建。
创建完成VSCode会自动切换到这个虚拟环境。
之后pip安装的所有库,只会作用于当前项目,不会污染全局环境。
现在新建一个test.py文件,写一行打印代码。
右键选择在终端运行Python文件,能正常输出内容,环境就配置完成了。
最后给大家总结几个高频踩坑点。
第一,pip装完库,VSCode还是提示找不到模块,99%是解释器选错,确认右下角的解释器和你pip用的是同一个。
第二,Windows终端中文乱码,配置终端编码为utf‑8即可。
第三,代码可以跑,但import有波浪线,属于代码检查工具的提示,不影响运行。