Hexvork
Python第一讲——Python和VS Code开发环境搭建教程

Python第一讲——Python和VS Code开发环境搭建教程

最近身边好多朋友想学Python,但第一步就卡在环境搭建上了。有的装了Python但VS Code识别不了,有的插件装了一堆但还是报错,还有的界面全英文看着头疼。

今天就来个一条龙服务,从Python安装到VS Code配置,再到汉化和插件推荐。从这篇文章起,我还会开一个新栏目 Python学习教程

准备工作:下载链接

Python官方下载

官网:https://www.python.org/

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.切换语言

装完后:

  1. Ctrl + Shift + P打开命令面板
  2. 输入”Configure Display Language”
  3. 选择”中文(简体)”
  4. 重启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解释器

解决步骤

  1. Ctrl + Shift + P
  2. 输入”Python: Select Interpreter”
  3. 手动选择Python安装路径(通常在C:\Users\用户名\AppData\Local\Programs\Python\

3.插件装不上

可能原因:网络问题
解决方案

  • 换个时间段试试
  • 用手机热点
  • 实在不行就科学上网

4.中文输入法在VS Code里有问题

解决:在设置里搜索”ime”,把”Editor: IME Mode”设为”on”

八、进阶建议

环境搭好只是第一步,后面还有很多可以折腾的:

  1. 虚拟环境:用venvconda管理不同项目的依赖
  2. Jupyter插件:在VS Code里直接运行Jupyter Notebook
  3. 远程开发:用SSH连接服务器写代码
  4. Git集成:版本控制,多人协作必备

总结

按照这个流程走下来,你应该已经有了一个能用、好用、中文界面的Python开发环境。

核心要点回顾:

  • Python安装时必须勾选PATH选项
  • VS Code的Python插件三件套不能少
  • 中文语言包让界面更友好
  • 遇到问题先检查PATH和解释器配置

现在可以愉快地开始Python学习之旅了!

Happy Coding!