![cover](https://img-blog.csdnimg.cn/direct/72a23ca9f0e445f18c027f1ab118ca7e.png)
「Python入门」五千字+50张图,超详细的 安装/汉化/使用VSCode 创建/运行python代码完整操作及教程
本文详细介绍了python的安装和vscode的安装+使用教程。五千字+50张图,专为萌新设计,保证能搞懂。
粗浅之言,如有错误,欢迎指正
前言
Python目前的主流编辑器有多个,例如 Sublime Text、VSCode、Pycharm、IDLE(安装python时自带的) 等。个人认为 vscode 虽然在大型项目上有所不足,但操作简单、界面简洁很适合初学者上手,比pycharm简单多了。本文详细介绍了python的安装和vscode的使用教程。
⚠️ 注:本文的操作在 Windows 10 上进行(win11的操作也一样),所讲述内容也只针对Windows系统和初学者。
Python安装
在介绍安装vscode之前,我们当然要先把python(也就是 python解释器)安装好,安装教程可参考这篇文章: python超详细安装教程。
VSCode介绍
Visual Studio Code(简称 VSCode)是微软在2015年正式宣布的一个运行于 Mac OS X 、Windows 和 Linux 之上,针对于编写现代Web和云应用的跨平台源代码编辑器。它具有对 JavaScript,TypeScript 和 Node.js 的内置支持,并具有丰富的其他语言(例如C++,C#,Java,Python,PHP,Go)和运行时(例如.NET和Unity)扩展的生态系统。该编辑器集成了所有一款现代编辑器所应该具备的特性,包括 语法高亮,可定制的热键绑定,括号匹配 以及 代码片段收集。
看不懂?没关系,知道它能写python代码就行了。
VSCode下载安装
点击进入VSCode官网下载最新版
老师给的软件包里有 vscode 的安装包,如下图所示(避免部分同学看不懂,因此给安装包改了名,安装包也是文件是可以改名的),你可以跳过这步直接进行安装,你也可以去官网自己去尝试一下如何下载。
截至文章发布时(2024.1月),vscode 最新版为1.85.1。值得注意的是官网提供的最新版在Windows上只支持 win10、win11 系统。
vscode提供了多种版本(Windows,Linux,Mac)可供下载。其中Windows版又分为 用户安装包(User Installer)、系统安装包(System Installer)、压缩包(.zip)、命令行界面版安装包(CLI),每个版本又以CPU架构区分为 x64版本 和 Arm64版本 。
看不懂?不需要看懂,点击红框所在的按钮进行下载就好啦。
下载完成之后这就是vscode的安装包。下面教程都以1.85.1版本为例。
- 双击打开安装包 ,选择 “我同意此协议” ,然后点击 “下一步” 。
- 选择安装位置 。如果不会自定义路径千万别乱搞,就直接默认路径就行了。然后点击 “下一步” 。
- 选择一下开始菜单的快捷方式 。这个不用管,直接 “下一步” 。
- 选择附加任务 。“创建桌面快捷方式” 是默认没有勾选的,我们可以勾选上。其他两个需不需要勾选就看自己需求,这个影响不大。然后点击 “下一步” 。
- 选择完成,准备安装了 。点击 “安装” 。
- 安装中 。
- 安装完成 。点击 “完成” ,vscode会自动打开。
如果电脑上已经有vscode,再次安装也不影响,vscode会根据已有的安装路径来进行更新(安装程序会省略第2步和第3步,其他步骤都一样)。
VSCode使用
安装python插件
虽然说我们一开始就安装好了python解释器,但是vscode和pycharm不大一样,pycharm能直接用,vacode需要再安装python的插件才能运行python代码。在安装python插件之前,我们先安装个vscode中文包吧。
- 先打开vscode侧边栏的拓展(也可以按快捷键:ctrl + shift + x)
- 然后在搜索框里搜索 “chinese”。一般第一个,带有微软标志的就是。点击 “Install” 进行下载安装。
- 保持网络通畅,等一会。安装好之后在右下角会弹出提示让我们重启一下vscode,我们点击 “Change Language and Restart” 进行重启。然后界面就变成中文了。
安装好中文包后我们继续安装 python插件 。
- 和安装中文包一样,我们搜索 “python”。一般第一个,带有微软标志的就是,点击 “安装” ( 当插件有 预发布版本 时旁边就会有个箭头,我们可以选择安装它的预发布版本,但一般正常安装就行了,预发布版本可能会有不稳定的问题)。
- 保持网络通畅,多等一会,python插件比较大有一百多兆,而且会附带下载另一个插件叫 Pylance,也有八九十兆。在安装过程中可能会在右下角弹出该提示,选择 “安装” 就好了。若没有弹出就不用管。
- 下载安装完成之后,会出现两个插件,一个是 Python,另一个就是 Pylance。Pylance 也是微软推出的一款帮助编写python代码的插件,它有很多作用,比如语法高亮、参数建议、代码补全、自动导入等等,非常好用。若没有自动下载的话可以手动去安装,操作和安装python插件一样:在搜索框搜索 “Pylance” 进行安装。
到这里我们就把插件安装完毕了,其实很简单吧,就安装了一个中文包和一个python插件(pylance是随python插件一起安装的)。
创建py文件
-
首先我们先选一个地方,右键 > 新建文件夹 ,专门用于存放python的练习代码(养成分门别类的好习惯)。不要选择C盘,最好选择其他盘。建好之后给文件夹重新命个名,最好是用英文、下划线、数字来命名,不要以数字开头(这也是python的命名规范哦)。这里我选择的是 D盘 ,文件夹名为 python_learning。
-
Python源代码文件的后缀为 .py ,它是一种纯文本文件。什么意思呢?意思就是我们可以通过修改文本文档的后缀来创建Python文件。我们首先在刚刚新建的专用文件夹里 右键 > 新建文本文档 来创建一个 全新的文本文档,如下图所示:
-
注意:新建的文本文档一定要有 .txt 后缀,就像上图一样。如果和下图一样就说明你没有打开文件拓展名显示,请按照下图操作去打开。“隐藏的项目”也是需要打开的,我们一并打开。(更详细的文件拓展名介绍:该链接第五章:文件后缀名)
win10 打开方式:
win11 打开方式:
-
然后 鼠标右键 - “重命名”,把 .txt 后缀改成 .py 来创建python源文件(也可以改成 .html、.css、.js 来生成其他类型的代码文件)。修改时会弹出警告,问你确定要更改吗?那是当然选 “是” 啦。如果没弹警告就是上一步没打开显示文件拓展名导致后缀名没修改到。
-
这样我们就得到了一份全新的 py文件(图标样式可能会变或不变,但都不重要没有影响,只要后缀名修改成功即可)。当然它里面什么都没有写(因为是全新的嘛)。注意:py文件不能双击打开,双击会直接运行而不是打开,如何打开往下有详细说明。
我们还可以在 vscode里面创建 py文件,下面会说到。
打开py文件
vscode打开py文件有两种方式:直接打开(不推荐) 和用 工程方式(推荐) 打开。
-
直接打开 就非常简单了(不推荐,可以看看了解一下):
- 第 1 种方式:把 py文件 直接拖到 vscode图标 上面就自动打开了。
- 第 2 种方式:先打开vscode,然后把 py文件直接 拖进去 也能打开。这是打开之后的样子,右下角的 3.11.6 64-bit 是最开始安装好的python版本。vscode会自动检测文件的语言类型并自动选择语言解释器(或编译器)。
如果 vscode 没有选择 python解释器,那可能是文件没有信任,在左下角点击 “ 受限模式 ” 进去选择信任文件即可。
然后 vscode 就会自动选择解释器,如果还没有自动选择,我们可以在右下角显示版本的地方, 点击 “选择解释器” 去手动添加 python解释器。- 如果出现了 python解释器,就直接选择即可。
- 不然就点击 “输入解释器路径”。
- 点击 “查找” 。
- 找到 python的安装路径(红框里的路径,是你自己安装python时的路径),选择 python.exe 这个程序,点击 “选择解释器” 。大功告成。
- 如果出现了 python解释器,就直接选择即可。
- 第 3 种方式:非常"正式"的方式,就是用vscode的 “打开文件…”(快捷键:Ctrl+O) 来打开。
- 第 1 种方式:把 py文件 直接拖到 vscode图标 上面就自动打开了。
-
用 工程模式 打开(推荐)
如果你的代码里面 不涉及到路径和调用其他文件,使用直接打开的方式就非常方便。但是一旦涉及到路径、调用其他文件(图片,文档、视频等),那么 运行的时候就非常非常容易报 “找不到路径或文件” 的错误(后面会解释原因),因此我们需要用另一种方式来打开py文件。-
第 1 种方式:直接拖,不过这次是拖文件夹,我们把文件夹拖进vscode。这是打开之后的样子
我们之前说过在 vscode里面创建py文件,把鼠标放在文件夹上,就会显示四个图标,分别是 “新建文件”,“新建文件夹”,“刷新”,“折叠该文件夹”。选择 “新建文件” 就可以创建py文件了,vscode不会帮用户填后缀名,所以记得要把后缀名写上哦。
-
第 2 种方式:用vscode的 打开文件夹…(快捷键:先按Ctrl+K 再按Ctrl+O) 来打开。
-
第 3 种方式:cmd中运行命令 打开。
- 首先进入文件夹里。
- 在上方地址栏输入 cmd 然后回车。
- 弹出cmd窗口之后再输入 code . (code 与 . 之间有空格)然后回车。
- 然后 vscode 就会自动打开了(使用这种方式需要在环境变量里添加vscode安装路径下的bin文件夹路径,安装时已经默认添加了,如果没有添加成功可手动添加)。 如何打开环境变量
- 首先进入文件夹里。
-
运行代码
打开文件之后我们在里面写上代码,然后可以运行一下看看效果。可选择 右上角绿色框里面的 三角形 运行按钮,或者 右键呼出菜单选择 “运行Python” — “在终端中运行Python文件”,二者都可以。
运行结果及解析:
工作目录释义:python工作目录 是python脚本、模块或项目存放的根目录,当python运行时,会默认去工作目录下寻找指定的文件或模块。
上图是用工程模式 打开之后运行文件,工作目录就是文件夹路径。 如果我们不用工程模式 而是直接打开文件去运行,那么工作目录一般默认是 C盘的当前用户目录,如下:
什么意思呢?就是python的相对路径是 以工作目录为起点的,而非文件所在位置。因此不清楚工作目录的话就容易把路径写错,从而出现前面所说的 “运行的时候会报找不到路径或文件” 的错误。
如果你不熟悉工作目录和相对路径,你某天可能会发现你的C盘用户目录下多了很多奇奇怪怪并眼熟的文件,那就是你平时运行python产生的文件。
注意:vscode的终端具有与cmd相同的功能,因此可能会不小心进入到终端的交互式命令行中(终端里出现 >>> ),只需要点垃圾桶清除重新运行就好了。
Python 工作目录
上面简单说了一下工作目录,这里以具体例子详细说明。
-
我们还是以前面的文件夹为例。在文件夹里新增图片 image_1.jpg 。又新建了一个子文件夹 test_2,里面有图片 image_2.jpg 和代码文件 test_2.py 。
-
首先来测试一下工作目录对绝对路径的影响。
- 直接打开文件。工作目录为
C:\Users\ASUS
,代码为打开C盘和D盘的图片,运行文件,我们发现并未报错。
- 工程模式打开文件。工作目录为
D:\python_learning
,运行文件我们发现也并未报错。
不论工作目录是什么都对绝对路径无影响。
- 直接打开文件。工作目录为
-
接着我们测试相对路径。我们以工程模式打开 python_learning文件夹(D:\python_learning),当前的工作目录为文件夹路径,即
D:\python_learning
。 -
运行 python_learning_1.py。
4-1. 采用相对路径的方式来打开图片 image_1.jpg,未报错。
4-2. 再次尝试打开子文件夹里的图片 image_2.jpg,也未报错。
-
运行子文件夹 test_2 里的文件 test_2.py,
5-1. 我们尝试打开图片 image_1.jpg。image_1.jpg 在 test_2.py 的上一级目录中,这里的相对路径按理说应该为../image_1.jpg
,尝试运行,但是报错 找不到文件或路径。
5-2. 改为image_1.jpg
,运行不报错。
5-3. 我们又尝试打开图片 image_2.jpg。image_2.jpg 与 test_2.py 同级,相对路径按理说应该为image_2.jpg
,但是运行也报错。
5-4. 改成test_2/image_2.jpg
,运行不报错。
-
现在我们使用 os库的 chdir 函数来修改一下工作目录试试。我们使用函数把工作目录修改为了
test_2
。
6-1. 现在我们再次尝试运行 5-1的代码,已经不会报错了。
6-2. 再次尝试运行 5-3的代码,也不报错。
-
现在我们利用 os库的 getcwd函数来获取一下 6-2的工作目录。可以看到工作目录是
D:\python_learning\test_2
。这说明工作目录确实已经被成功更改了。
-
刚刚是用工程模式打开之后来测试相对路径,这次我们直接打开来测试一下。通过上文我们知道 直接打开文件后的工作目录是
C:\Users\ASUS
。现在我们尝试打开C盘 下载(Downloads)目录下的一张壁纸(第二步的C盘里的图片),运行成功没有报错。
-
还是一样,我们也修改一下工作目录并打印出来看看。可以看到工作目录成功修改为
C:\Users\ASUS\Downloads
,且相对路径也发生了变化。
-
通过以上举例说明不论是在 python_learning_1.py 还是 test_2.py 文件中,不论是工程模式打开还是直接打开,相对路径的起点始终是工作目录,因此工作目录不清除明确 写路径就会很容易出错。
-
但是如果你有一点python基础,就会感到疑惑:我以前写路径不是这样的呀。是的,平时的路径确实不是这样的,这是因为vscode的python插件的问题,导致: vscode执行python程序的时候,如果涉及到相对路径,那么都是以workspace路径(工作目录)开始的,而不是执行文件的所在文件夹,也就是上面说的情况。
-
那么如何解决呢?怎么让他回到正常的路径样子呢?我们只需要打开 vscode的
设置 - 拓展 - python - 找到如下选项并勾选
,这样以后相对路径的起点就是以 执行文件的所在文件夹位置开始了。参考文档:[vscode] 配置python执行的相对路径
总结:
- 若是不勾选 Terminal:Execute In File Dir 选项(默认是不勾选的),那么建议用 vscode 打开文件时都用工程模式打开。明确文件的工作目录,可用 os.chdir 函数更改, os.getcwd 函数获取。
- 若是勾选 Terminal:Execute In File Dir 选项,则正常写相对路径。
注意:使用 os.chdir 时,如果是填写的相对路径也要遵循工作目录的原则。
VSCode更新
vscode很热衷更新,基本上会自动更新版本。如果没有自动更新,你可以点击 “帮助” - “检查更新”。
注意事项
- VSCode不是万能的,它是专门写代码的软件,只能打开文本文件、部分格式的图片和视频(视频可能没声音)。每种文件有它自己的软件去打开,不要什么文件都想用vscode打开。
Tip:
如果你对本文所说的某些词语(比如解释器、编辑器、cmd)或操作不甚理解,可以看看这篇文章 关于Python安装、pip、报错常见问题答疑,也许对你有些帮助。
![Logo](https://devpress.csdnimg.cn/79de2bf0b7994defa4242ef90d5513fa.jpg)
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)