「Python入门」五千字+50张图，超详细的 安装/汉化/使用VSCode 创建/运行python代码完整操作及教程_vscode安装+汉化+配置python(保姆级教程!)

粗浅之言，如有错误，欢迎指正

---

前言

Python目前的主流编辑器有多个，例如 Sublime Text、VSCode、Pycharm、IDLE(安装python时自带的) 等。个人认为 vscode 虽然在大型项目上有所不足，但操作简单、界面简洁很适合初学者上手。本文详细介绍了python的安装和vscode的使用教程。

⚠️ 注：本文的操作在 Windows 10 上进行，所讲述内容也只针对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官网下载最新版
截至文章发布时(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版本为例。

1. 双击打开安装包 ，选择 “我同意此协议” ，然后点击 “下一步” 。
   
2. 选择安装位置 。如果不会自定义路径千万别乱搞，就直接默认路径就行了。然后点击 “下一步” 。
   
3. 选择一下开始菜单的快捷方式 。这个不用管，直接 “下一步” 。
   
4. 选择附加任务 。“创建桌面快捷方式” 是默认没有勾选的，我们可以勾选上。其他两个需不需要勾选就看自己需求，这个影响不大。然后点击 “下一步” 。
   
5. 选择完成，准备安装了 。点击 “安装” 。
   
6. 安装中 。
   
7. 安装完成 。点击 “完成” ，vscode会自动打开。
   

如果电脑上已经有vscode，再次安装也不影响，vscode会根据已有的安装路径来进行更新（安装程序会省略第2步和第3步，其他步骤都一样）。

---

VSCode使用

安装python插件

虽然说我们一开始就安装好了python解释器，但是vscode和pycharm不大一样，pycharm能直接用，vacode需要再安装python的插件才能运行python代码。在安装python插件之前，我们先安装个vscode中文包吧。

1. 先打开vscode侧边栏的拓展（也可以按快捷键：ctrl + shift + x）
   
2. 然后在搜索框里搜索 “chinese”。一般第一个，带有微软标志的就是。点击 “Install” 进行下载安装。
   
3. 保持网络通畅，等一会。安装好之后在右下角会弹出提示让我们重启一下vscode，我们点击 “Change Language and Restart” 进行重启。然后界面就变成中文了。
   

安装好中文包后我们继续安装 python插件 。

1. 和安装中文包一样，我们搜索 “python”。一般第一个，带有微软标志的就是，点击 “安装” （ 当插件有 预发布版本 时旁边就会有个箭头，我们可以选择安装它的预发布版本，但一般正常安装就行了，预发布版本可能会有不稳定的问题）。
   
2. 保持网络通畅，多等一会，python插件比较大有一百多兆，而且会附带下载另一个插件叫 Pylance，也有八九十兆。在安装过程中可能会在右下角弹出该提示，选择 “安装” 就好了。若没有弹出就不用管。
   
3. 下载安装完成之后，会出现两个插件，一个是 Python，另一个就是 Pylance。Pylance 也是微软推出的一款帮助编写python代码的插件，它有很多作用，比如语法高亮、参数建议、代码补全、自动导入等等，非常好用。若没有自动下载的话可以手动去安装，操作和安装python插件一样：在搜索框搜索 “Pylance” 进行安装。
   

到这里我们就把插件安装完毕了，其实很简单吧，就安装了一个中文包和一个python插件（pylance是随python插件一起安装的）。

创建py文件

1. 首先我们先选一个地方，右键 > 新建文件夹 ，专门用于存放python的练习代码（养成分门别类的好习惯）。不要选择C盘，最好选择其他盘。建好之后给文件夹重新命个名，最好是用英文、下划线、数字来命名，不要以数字开头（这也是python的命名规范哦）。这里我选择的是 D盘 ，文件夹名为 python_learning。
   

2. Python源代码文件的后缀为 .py ，它是一种纯文本文件。什么意思呢？意思就是我们可以通过修改文本文档的后缀来创建Python文件。我们首先在刚刚新建的专用文件夹里 右键 > 新建文本文档 来创建一个 全新的文本文档，如下图所示
   

3. 然后 把 .txt 后缀改成 .py 来创建python源文件（修改后缀需要先把文件拓展名打开，如果新建的文本文档没有 .txt 后缀，就说明文件拓展名没打开。怎么打开？当然是百度在手，天下我有了）。修改时会弹出警告，问你确定要更改吗？那是当然选 “是” 啦。
   

4. 这样我们就得到了一份全新的 py文件（图标也变成了python图标。但如果图标没变也没有关系，这个什么都不影响，说不定以后就变了），当然它里面什么都没有写（因为是全新的嘛）。
   

我们还可以在 vscode里面创建 py文件，下面会说到。

打开py文件

vscode打开py文件有两种方式：直接打开 和 用工程方式打开。

1. 直接打开 就非常简单了：

   • 第 1 种方式：把 py文件 直接拖到 vscode图标 上面就自动打开了。
     
   • 第 2 种方式：先打开vscode，然后把 py文件直接 拖进去 也能打开。这是打开之后的样子，右下角的 3.11.6 64-bit 是最开始安装好的python版本。vscode会自动检测文件的语言类型并自动选择语言解释器(或编译器)。
     
     如果vscode没有自动选择 python解释器，我们可以点击 右下角的 “选择解释器” 去手动添加 python解释器。
     1. 点击 “输入解释器路径”。
        
     2. 点击 “查找” 。
        
     3. 找到 python的安装路径（红框里的路径），选择 python.exe 这个程序，点击 “选择解释器” 。大功告成。
        
   • 第 3 种方式：非常"正式"的方式，就是用vscode的 “打开文件…”(快捷键：Ctrl+O) 来打开。
     

2. 用 工程模式 打开（推荐）
   如果你的代码里面 不涉及到路径和调用其他文件，使用直接打开的方式就非常方便。但是一旦涉及到路径、调用其他文件（图片，文档、视频等），那么 运行的时候就非常非常容易报 “找不到路径或文件” 的错误（后面会解释原因），因此我们需要用另一种方式来打开py文件。

   • 第 1 种方式：直接拖，不过这次是拖文件夹，我们把文件夹拖进vscode。这是打开之后的样子
     
     我们之前说过在 vscode里面创建py文件，把鼠标放在文件夹上，就会显示四个图标，分别是 “新建文件”，“新建文件夹”，“刷新”，“折叠该文件夹”。选择 “新建文件” 就可以创建py文件了，vscode不会帮用户填后缀名，所以记得要把后缀名写上哦。
     

   • 第 2 种方式：用vscode的 打开文件夹…(快捷键：先按Ctrl+K 再按Ctrl+O) 来打开。
     

   • 第 3 种方式：cmd中运行命令 打开。

     1. 首先进入文件夹里。
        
     2. 在上方地址栏输入 cmd 然后回车。
        
     3. 弹出cmd窗口之后再输入 code . （code 与 . 之间有空格）然后回车。
        
     4. 然后 vscode 就会自动打开了（使用这种方式需要在环境变量里添加vscode安装路径下的bin文件夹路径，安装时已经默认添加了，如果没有添加成功可手动添加）。 如何打开环境变量
        

运行代码

打开文件之后我们在里面写上代码，然后可以运行一下看看效果。可选择 右上角绿色框里面的 三角形 运行按钮，或者 右键呼出菜单选择 “运行Python” — “在终端中运行Python文件”，二者都可以。

运行结果及解析：

工作目录释义：python工作目录 是python脚本、模块或项目存放的根目录，当python运行时，会默认去工作目录下寻找指定的文件或模块。

上图是用工程模式 打开之后运行文件，工作目录就是文件夹路径。 如果我们不用工程模式 而是直接打开文件去运行，那么工作目录一般默认是 C盘的当前用户目录，如下：

什么意思呢？就是python的相对路径是 以工作目录为起点的，而非文件所在位置。因此不清楚工作目录的话就容易把路径写错，从而出现前面所说的 “运行的时候会报找不到路径或文件” 的错误。

如果你不熟悉工作目录和相对路径，你某天可能会发现你的C盘用户目录下多了很多奇奇怪怪并眼熟的文件，那就是你平时运行python产生的文件。

注意：vscode的终端具有与cmd相同的功能，因此可能会不小心进入到终端的交互式命令行中(终端里出现 >>> )，只需要点垃圾桶清除重新运行就好了。

Python 工作目录

上面简单说了一下工作目录，这里以具体例子详细说明。

1. 我们还是以前面的文件夹为例。在文件夹里新增图片 image_1.jpg 。又新建了一个子文件夹 test_2，里面有图片 image_2.jpg 和代码文件 test_2.py 。
   

2. 首先来测试一下工作目录对绝对路径的影响。

   • 直接打开文件。工作目录为 C:\Users\ASUS，代码为打开C盘和D盘的图片，运行文件，我们发现并未报错。
     
   • 工程模式打开文件。工作目录为 D:\python_learning，运行文件我们发现也并未报错。
     
     不论工作目录是什么都对绝对路径无影响。

3. 接着我们测试相对路径。我们以工程模式打开 python_learning文件夹（D:\python_learning），当前的工作目录为文件夹路径，即 D:\python_learning。

4. 运行 python_learning_1.py。
   4-1. 采用相对路径的方式来打开图片 image_1.jpg，未报错。
   
   4-2. 再次尝试打开子文件夹里的图片 image_2.jpg，也未报错。
   

5. 运行子文件夹 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，运行不报错。
   

6. 现在我们使用 os库的 chdir 函数来修改一下工作目录试试。我们使用函数把工作目录修改为了 test_2。
   6-1. 现在我们再次尝试运行 5-1的代码，已经不会报错了。
   
   6-2. 再次尝试运行 5-3的代码，也不报错。
   

7. 现在我们利用 os库的 getcwd函数来获取一下 6-2的工作目录。可以看到工作目录是 D:\python_learning\test_2。这说明工作目录确实已经被成功更改了。
   

8. 刚刚是用工程模式打开之后来测试相对路径，这次我们直接打开来测试一下。通过上文我们知道 直接打开文件后的工作目录是 C:\Users\ASUS。现在我们尝试打开C盘 下载(Downloads)目录下的一张壁纸（第二步的C盘里的图片），运行成功没有报错。
   

9. 还是一样，我们也修改一下工作目录并打印出来看看。可以看到工作目录成功修改为 C:\Users\ASUS\Downloads，且相对路径也发生了变化。
   

10. 通过以上举例说明不论是在 python_learning_1.py 还是 test_2.py 文件中，不论是工程模式打开还是直接打开，相对路径的起点始终是工作目录，因此工作目录不清除明确 写路径就会很容易出错。

11. 但是如果你有一点python基础，就会感到疑惑：我以前写路径不是这样的呀。是的，平时的路径确实不是这样的，这是因为vscode的python插件的问题，导致： vscode执行python程序的时候，如果涉及到相对路径，那么都是以workspace路径（工作目录）开始的，而不是执行文件的所在文件夹，也就是上面说的情况。

12. 那么如何解决呢？怎么让他回到正常的路径样子呢？我们只需要打开 vscode的 设置 - 拓展 - python - 找到如下选项并勾选，这样以后相对路径的起点就是以 执行文件的所在文件夹位置开始了。参考文档：[vscode] 配置python执行的相对路径
    

总结：

1. 若是不勾选 Terminal：Execute In File Dir 选项（默认是不勾选的），那么建议用 vscode 打开文件时都用工程模式打开。明确文件的工作目录，可用 os.chdir 函数更改， os.getcwd 函数获取。
2. 若是勾选 Terminal：Execute In File Dir 选项，则正常写相对路径。

注意：使用 os.chdir 时，如果是填写的相对路径也要遵循工作目录的原则。

Tip：
如果你对本文所说的某些词语（比如解释器、编辑器、cmd）或操作不甚理解，可以看看这篇文章 关于Python安装、pip、报错常见问题答疑，也许对你有些帮助。