最近身边好多朋友想学Python,但第一步就卡在环境搭建上了。有的装了Python但VS Code识别不了,有的插件装了一堆但还是报错,还有的界面全英文看着头疼。
今天就来个一条龙服务,从Python安装到VS Code配置,再到汉化和插件推荐。从这篇文章起,我还会开一个新栏目 Python学习教程。
准备工作:下载链接
Python官方下载
VS Code官方下载
官网:https://code.visualstudio.com/
一、Python安装(重点是PATH设置)
1.下载对应版本
去Python官网点”Downloads”,系统会自动推荐适合你的版本:
- Windows:选64-bit的installer
- macOS:Intel芯片选x64,M系列选arm64
- Linux:一般系统自带,没有的话用包管理器装
2.安装时的关键步骤
Windows用户注意:双击安装包后,第一个界面必须勾选”Add Python to PATH”!
这个选项超级重要,不勾的话后面命令行识别不了Python,还得手动配环境变量,非常麻烦。
勾选后直接点”Install Now”,等进度条跑完就行。
3.验证安装
按Win + R,输入cmd打开命令行,然后试试这两个命令:
python --version
pip --version
如果都能显示版本号,说明装成功了。要是提示”不是内部或外部命令”,那就是PATH没配好,重新装一遍Python记得勾选那个选项。
二、VS Code安装与基础配置
1.下载安装
VS Code官网下载对应系统的版本,安装时建议把这几个选项都勾上:
- “将’通过Code打开’操作添加到文件上下文菜单”
- “将’通过Code打开’操作添加到目录上下文菜单”
- “将Code注册为受支持的文件类型的编辑器”
- “添加到PATH”
这样以后右键文件夹就能直接用VS Code打开,很方便。
三、Python插件安装(必装清单)
1.核心插件
按Ctrl + Shift + X打开扩展商店,搜索”Python”,装这几个:
必装三件套:
- Python - 微软官方出品,Python支持的核心
- Pylance - 语言服务器,代码提示和错误检查
- Python Debugger - 调试器,找bug必备
这三个装完基本就能正常写Python了。
2.提升体验的插件
推荐装的:
- autoDocstring - 自动生成函数注释,省事
- Python Indent - 智能缩进,Python对缩进要求严格
- Bracket Pair Colorizer - 括号配对高亮,嵌套多了不容易看错
- GitLens - Git增强,版本管理神器
- Material Icon Theme - 文件图标美化,看着舒服
3.配置Python解释器
插件装完后,按Ctrl + Shift + P打开命令面板,输入”Python: Select Interpreter”,选择刚才装的Python版本。
如果找不到,说明PATH配置有问题,回到第一步重新装Python。
四、界面汉化(英语不好的福音)
1.安装中文语言包
在扩展商店搜索”Chinese”,找到”Chinese (Simplified) Language Pack for Visual Studio Code”,点击安装。
2.切换语言
装完后:
Ctrl + Shift + P打开命令面板- 输入”Configure Display Language”
- 选择”中文(简体)”
- 重启VS Code
重启后界面就变中文了,菜单、设置、错误提示都是中文,看着亲切多了。
五、写第一个Python程序
1.创建项目
新建个文件夹叫”python_test”,在VS Code里”文件” → “打开文件夹”选择这个文件夹。
2.写代码
右键新建文件,命名为”hello.py”,输入:
# 我的第一个Python程序
print("Hello, World!")
3.运行程序
方法一:按Ctrl + F5直接运行
方法二:右上角点”▷“运行按钮
如果能看到输出结果,恭喜你,环境搭建成功!
六、常用配置优化
1.代码格式化
在设置里搜索”python formatting”,推荐用Black格式化工具:
pip install black
然后在VS Code设置里加上:
{
"python.formatting.provider": "black",
"editor.formatOnSave": true
}
这样保存文件时会自动格式化代码,强迫症福音。
2.代码检查
装个pylint检查代码质量:
pip install pylint
VS Code会自动识别并在代码下面显示波浪线提示问题。
3.主题和字体
推荐主题:Dark+ (默认深色) 或者 Material Theme
推荐字体:Fira Code(支持连字符,看起来更专业)
七、常见问题救急
1.”python不是内部或外部命令”
原因:PATH环境变量没配好
解决:重新安装Python,记得勾选”Add Python to PATH”
2.VS Code找不到Python解释器
解决步骤:
Ctrl + Shift + P- 输入”Python: Select Interpreter”
- 手动选择Python安装路径(通常在
C:\Users\用户名\AppData\Local\Programs\Python\)
3.插件装不上
可能原因:网络问题
解决方案:
- 换个时间段试试
- 用手机热点
- 实在不行就科学上网
4.中文输入法在VS Code里有问题
解决:在设置里搜索”ime”,把”Editor: IME Mode”设为”on”
八、进阶建议
环境搭好只是第一步,后面还有很多可以折腾的:
- 虚拟环境:用
venv或conda管理不同项目的依赖 - Jupyter插件:在VS Code里直接运行Jupyter Notebook
- 远程开发:用SSH连接服务器写代码
- Git集成:版本控制,多人协作必备
总结
按照这个流程走下来,你应该已经有了一个能用、好用、中文界面的Python开发环境。
核心要点回顾:
- Python安装时必须勾选PATH选项
- VS Code的Python插件三件套不能少
- 中文语言包让界面更友好
- 遇到问题先检查PATH和解释器配置
现在可以愉快地开始Python学习之旅了!
Happy Coding!