「Python入门」vscode创建/运行python文件教程

本篇教程只介绍简单的操作方式：更详细的vscode教程请点击这里。

创建 .py文件

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

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


3. 注意：新建的文本文档一定要有 .txt 后缀，就像上图一样。如果和下图一样就说明你没有打开文件拓展名显示，请按照下图操作去打开。“隐藏的项目”也是需要打开的，我们一并打开。（更详细的文件拓展名介绍：该链接第五章：文件后缀名）

win10 打开方式：

win11 打开方式：

4. 然后 鼠标右键 - “重命名”，把 .txt 后缀改成 .py 来创建python源文件（也可以改成 .html、.css、.js 来生成其他类型的代码文件）。修改时会弹出警告，问你确定要更改吗？鼠标选择 “是” 或者 按下回车键。如果没弹警告就是上一步没打开显示文件拓展名导致后缀名没修改到。


5. 这样我们就得到了一份全新的 py文件（图标样式可能会变或不变，但都不重要没有影响，只要后缀名修改成功即可）。当然它里面什么都没有写（因为是全新的嘛）。注意：py文件不能双击打开，双击会直接运行而不是打开，如何打开往下有详细说明。

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

打开 .py文件

这是vscode 的欢迎页，不用管它，也可以叉掉它。

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

• 直接打开就直接把py文件拖进vscode就好了，非常简单，但是 不推荐这种方式，所以不做介绍。

• 用 工程模式 打开（推荐，以后都用这种方式）。
  代码一旦涉及到路径、调用其他文件（图片，文档、视频等），我们需要用 工程目录 的方式来打开py文件。

  1. 具体操作：拖文件夹，我们把py文件所在的文件夹拖进vscode（如果vscode已经打开了其他文件也不用怕，拖进去后会自动关闭其他无关的文件），以上面创建的 python_learning 文件夹为例，这是拖动和打开之后的样子：
     
     
  2. 我们之前说过在 vscode里面创建py文件，把鼠标放在文件夹上，就会显示四个图标，分别是 “新建文件”，“新建文件夹”，“刷新”，“折叠该文件夹”。选择 “新建文件” 就可以创建py文件了，vscode不会帮用户填后缀名，所以记得要把后缀名写上哦。
     

运行代码

鼠标右键 写代码的区域^{（注意不是左侧放文件的区域）}，呼出菜单选择 “运行Python” — “在终端中运行Python文件” 即可运行。

• 如果无法运行，先查看是否安装了python插件（vscode安装教程 里有，这里不说了），然后查看vscode右下角是否自动选择了python解释器，即这样：
  
  如果没有显示版本，那就是vscode没有自动选择，先点击绿色箭头指向的版本号，上方就会显示你之前安装好的python解释器，点击选择即可配置成功。（我的电脑安装了多个python，你们应该只有一个，如果你们也有多个就选择后面有 “全局” 的）
  
• 如果右键没有 “运行Python” 的选项，那可能是文件没有信任，在左下角点击 “受限模式” 进去选择信任文件即可。
  

---

工程目录（重点！！！）

又叫工作目录、项目根目录、工程模式等。

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

1. 以刚才打开的项目文件为例：python_learning 文件夹就是我们的整个项目，同时 python_learning 也是该项目的根目录（工作目录）。我们接下来举例说明，先运行下面的代码。
   

2. 可以看到 demo.txt 这个文件在根目录生成了。
   

3. 现在我在根目录下又创建了一个文件夹叫 python_02 ，里面有一个py文件 test02.py，我在这个文件里运行代码，
   

4. 可以看到 demo02.txt 这个文件还是在根目录 python_learning 下生成的。
   

5. 我们修改一下代码里的路径，demo03.txt 才在 python_02 文件夹里出现。
   

6. 以上示例我用的 w 写文件，如果你用 r 读文件，道理也是一样的，路径写错了就会出现找不到文件的报错，比如这样：虽然demo03.txt 和 test02.py 在同一目录下，但是直接写就是错的。
   

7. 改一下路径，从根目录 python_learning 开始写文件的路径，就能成功读取。
   

8. 所以可以得出结论：vscode执行python程序的时候，如果涉及到写相对路径，那么都是以根目录（即 你拖进vscode的文件夹）开始的，而不是py文件的所在文件夹，也就是上面所呈现的例子。

9. 如何取消？我们只需要打开 vscode的 设置 - 拓展 - python - 找到如下选项并勾选
   
   

10. 勾选之后试验一下，成功。py文件在哪里 txt就在哪里生成。
    
    同一目录下的文件直接写也可以正确读取文件了。
    

---

更详细的vscode教程：更详细的教程请点击这里。