YOLO从零到论文：模型改进与科研实战全攻略
YOLO基础篇 · A03
作者：迪菲赫尔曼
大家好，我是迪菲赫尔曼。
上一张目录树，大家还记得吗？
yolo-study └── images └── bus.jpg上一篇，我们已经在自己的电脑里把它建立好了。
今天继续用这一份文件夹，学习一个后面会一直用到的软件——Visual Studio Code，简称VS Code。
这篇做完，你应该能在里面创建并保存hello.py，把第一篇记下的学习目标也保存好。
开始前，请先在文件管理器里找到自己的yolo-study，确认里面的images/bus.jpg还在。找不到的话，先回到第 2 篇完成最后的检查，再继续。
1. 先把 VS Code 安装好
我们以后会用 VS Code 打开项目、编辑代码、查看运行结果。先把它当成写代码的工作台。
官方下载地址：Visual Studio Code 下载页
进入后，注意核对完整名称Visual Studio Code，再选择自己电脑的系统。
如果你已经安装好了，直接跳到第 2 节，打开上一篇的学习目录。
1.1 Windows 同学
普通个人电脑可以按官方提供的User Installer路线安装。
下载页如果需要区分x64和Arm64，按自己系统类型选择。可以从“开始 → 设置 → 系统”中进入“系统信息”或“关于”，查看“系统类型”，再返回下载页选择对应安装包。
下载完成后：
- 打开下载好的安装程序。
- 阅读并确认安装协议。
- 按向导选择安装位置并继续。
- 如果选项中有“使用 Code 打开”或“添加到 PATH”，可以保留这些便利选项。
- 等安装完成，再从开始菜单打开 Visual Studio Code。
本篇使用软件菜单操作。上面的 PATH 是后面命令行可能用到的设置，现在不用先研究它。
安装包类型和选项可以对照官方 Windows 安装说明。
1.2 Mac 同学
从下载页选择 macOS 对应的包，按自己的芯片类型选择。芯片信息可以从左上角苹果菜单的“关于本机”查看。
下载后按文件类型打开或解压，把Visual Studio Code.app放进“应用程序”，然后从“应用程序”中打开。
操作可对照官方 macOS 安装说明。下面保存文件时，Mac 使用Command + S。
1.3 安装后先找到软件主界面
第一次打开，可能看到欢迎页面、主题选择或一些功能介绍。
先从顶部菜单找到“文件 / File”。后面就从这个入口打开自己的文件夹。
如果现在是英文界面，也可以继续按本文的英文菜单操作。想切换中文的同学，可以按下面做：
- Windows 按
Ctrl + Shift + P；Mac 按Command + Shift + P。 - 顶部出现一个输入框，这叫命令面板。
- 输入
Configure Display Language，选择同名命令。 - 选择简体中文，通常标记为
zh-cn。 - 按提示安装语言包并重启。
重新打开后，检查菜单是否已经变成中文。这是官方提供的显示语言切换方式。
刚才这个查找功能的命令面板，先记住它的位置。它和后面要用的终端是两个地方。
2. 打开上一篇的 yolo-study
点击顶部菜单：
文件 → 打开文件夹…… File → Open Folder…在弹出的选择窗口中，找到上一篇建立的yolo-study。
这次选的是外层yolo-study文件夹。选好后，按窗口中的“选择文件夹”或“打开”确认。
这里容易点错，我们对照一下：
yolo-study ← 本篇打开这个文件夹 └── images └── bus.jpg如果只打开images，后面新建文件的位置就和文章不同；如果只是双击bus.jpg，也不是打开整个学习目录。
官方入门同样使用打开文件夹的方式建立项目工作范围。
打开成功后，先检查左侧
左侧应该能看到YOLO-STUDY或yolo-study，展开后能看到images。
点开images，再点一下bus.jpg，中间应显示我们上一篇保存的那张图片。
能看到熟悉的图片，就把前后两篇的文件对上了。
如果左侧显示“尚未打开文件夹”，请重新打开yolo-study。
如果左侧列表被隐藏，可以通过：
查看 → 资源管理器 View → Explorer把它显示出来。
如果有“信任”或“受限模式”提示
确认当前打开的是自己刚刚建立、只放了练习资料的yolo-study，就可以选择信任这个文件夹。若显示受限模式，通过提示中的管理入口处理。
以后打开别人提供的项目，要根据来源和内容判断。这里的提示作用可参考官方工作区信任说明。
这是 macOS 的文件夹选择框，当前已经进入yolo-study，点右下角“打开”就是打开这个目录。不要再点进images，否则左侧根目录就变了。Windows 对话框外观不同，仍然选择外层yolo-study。
3. 先认识三个位置，后面就知道去哪里操作
下面是我在当前 VS Code 中打开本篇练习目录的真实截图。先看左侧的yolo-study，再看中间打开的hello.py：
截图使用 macOS，Windows 的窗口按钮位置会不同；文件列表和编辑区的作用相同。下方终端还没有展开，第 8 节再操作。图中代码会在第 5 节一起保存，现在只认位置。
先找到三个地方：
| 位置 | 名称 | 后面用来做什么 |
|---|---|---|
| 左侧文件列表 | 资源管理器 | 打开文件、新建文件、查看目录 |
| 中间显示文件内容的区域 | 编辑区 | 写代码、看图片、修改文本 |
| 下方带提示符的面板 | 终端 | 输入运行命令，查看输出和报错 |
刚才点击bus.jpg后，图片显示在中间；等会儿打开.py文件，代码也会显示在中间。
你的终端现在可能还没打开，第 8 节会一起找。先把左侧列表和中间编辑区对上。
4. 新建 hello.py：这次要放在外层
在左侧，找到最外层的yolo-study。
在这个文件夹名称上点击右键，选择：
新建文件 New File输入文件名：
hello.py按回车。
现在请看左侧的位置：hello.py应该和images并排，放在yolo-study下面。
yolo-study ├── images │ └── bus.jpg └── hello.py上一篇已经讲过扩展名。这里hello是名字，.py表示我们准备保存 Python 代码。
名字末尾只写.py，不要再加.txt。
建错位置怎么办？
如果在images上右键新建，hello.py就可能跑到图片文件夹里。
这次文件刚建好，还没有重要内容，可以直接把它从左侧拖到外层yolo-study，确认移动目标正确，再核对目录树。
如果你不确定拖到哪里了，就用文件管理器打开yolo-study检查。先把位置理清，再继续写代码。
出现的是文件夹，怎么办？
看你刚才是不是点成了“新建文件夹”。
确认那个误建的hello.py文件夹是空的、确实由自己刚建，再整理掉；然后在外层yolo-study上选择“新建文件”。
正确完成后，左侧有一个hello.py文件，中间打开它的空白编辑区。
5. 写两行代码，按保存
用鼠标点进中间的hello.py，输入或复制：
print("大家好，我开始学习 YOLO 了。")print("这是我保存的第一份 Python 代码。")print()后面会用来输出文字。我们先把代码保存下来，后面的 Python 与环境课再带着运行。
注意复制范围：只复制这两行，不要把文章里代码块外面的反引号一起复制进去。
然后保存：
- Windows：
Ctrl + S； - Mac：
Command + S； - 或点击“文件 → 保存 / File → Save”。
没有开启自动保存时，文件修改后，顶部标签通常会出现未保存标记；保存后标记会消失。
再确认一次，文件是不是存在于电脑上
在左侧hello.py上点击右键。
Windows 选择名称类似“在文件资源管理器中显示 / Reveal in File Explorer”的选项；Mac 选择“在访达中显示 / Reveal in Finder”。
打开后，检查实际位置：
yolo-study ├── images └── hello.py这一步和上一篇找图片是同一种思路：通过文件所在的位置，确认我们编辑的是哪一份。
回到 VS Code，关闭hello.py的顶部标签，再从左侧重新打开。
如果保存的两行代码还在，就完成了这次保存检查。
关闭标签只是暂时不显示文件；我们没有选择删除文件，它就仍然在原位置。
5.1 为什么一定要做“保存后重新打开”这一步？
编辑区里已经能看到文字，只能说明编辑器目前显示了这些内容。文件是否已经保存到磁盘，是另一件事。
想象你在纸上打草稿，还没有把它放进正式资料夹。眼前能看见，不等于下次从资料夹还能找到。
所以，我们刚才连续做了三次核对：
写进编辑区 ↓ 保存到 hello.py ↓ 从实际文件位置重新打开，检查内容后面修改训练参数时也一样。如果文件没有保存，你运行的可能仍然是旧内容。现在先养成保存、核对的习惯。
5.2 这两行代码中的符号，先检查哪里？
先不要求你理解全部语法。把输入法切换到英文状态，检查两处：
print 后面是一对英文括号 () 文字外面是一对英文双引号 ""文字内容可以写中文，中文句号也可以留在引号里面。但构成代码结构的括号和引号，按示例使用英文符号。
下面只是错误写法展示，不要放进hello.py：
print（“大家好”）看起来很像，实际用了中文括号和弯引号。第五篇会具体解释字符串和函数调用，再告诉大家怎样从报错判断问题。
另外，每行前面现在都不需要空格。不用为了让代码“看起来靠中间”，手动在print前面打很多空格。
6. 再建一个 notes.txt，把第一篇的记录保存进来
还记得第一篇留的三句话吗？
现在继续在最外层yolo-study上右键，选择“新建文件”，输入：
notes.txt打开以后，把自己的记录写进去。可以按下面的格式组织：
我的学习目标： 这里写我想处理的图片，以及希望得到什么结果。 我的电脑系统： 这里写自己的实际系统。 我的学习目录： 这里记录自己实际建立 yolo-study 的位置。把说明文字换成自己的内容。还没有课题，就写“先跟着教学案例学习，暂未确定研究任务”。
再用同样的快捷键保存。
现在我们的目录多了两个文件：
yolo-study ├── images │ └── bus.jpg ├── hello.py └── notes.txthello.py放代码，notes.txt放学习记录。文件名和位置都已经是我们自己操作过的了。
7. 找到 Python 插件，分清它和 Python 环境
为了方便后面编辑 Python，接着认识一下 VS Code 的“扩展”。
可以把扩展理解成给编辑器增加功能的插件。
操作步骤：
点击左侧“扩展 / Extensions”图标，通常由几个小方块组成。
在扩展搜索框输入：
@id:ms-python.python找到名字为Python、发布者为Microsoft的扩展。
点击“安装 / Install”，等待完成。
用完整标识搜索，可以减少同名结果的干扰。这种搜索方式见官方扩展市场说明。
装好后，按钮通常会变成“禁用”“卸载”等管理入口。
为什么安装后，还可能提示选择 Python？
因为Python 插件和 Python 解释器，需要分别准备。
插件帮助编辑器处理 Python 代码；解释器负责执行代码。这一点，微软的 Python 文档也作了区分。
如果电脑还没有准备好解释器，出现选择或安装提示，并不代表前面创建文件失败了。
环境篇会继续配置它，并核对实际运行的是哪一个 Python。
如果插件下载失败，先记下扩展页面的错误信息；本篇前面的文件仍然可以创建、编辑和保存。不要因为下载问题反复新建同名学习目录。
认准 Microsoft 发布者和ms-python.python，不用逐字对齐版本号。截图中扩展已经安装；因为演示目录仍处于受限模式，界面提示扩展暂不可用。这不等于没有安装，按前文“信任或受限模式”说明处理自己建立的练习目录。
8. 打开终端，看清它和代码区的区别
点击顶部菜单：
终端 → 新建终端 Terminal → New Terminal通常会在下方出现一个面板。
Windows 上可能看到类似：
PS C:\Users\XiaoMing\Documents\yolo-study>这是提示符示例，不是要大家复制输入的命令。实际用户名、文件位置和提示符会不同。
在 Mac 上，你可能看到用户名、目录与%。其他 Shell 也会有不同显示。
终端的创建方式可对照官方终端入门。
当前先认位置：
- 刚才两行 Python 代码放在中间的
hello.py； - 下方终端是后面输入运行命令的位置；
- 前面切换语言时弹出的顶部输入框，是命令面板。
这三个入口，先分别找到一次。
下一篇再练习在终端查看目录、切换位置，以及分清 Shell 和 Python 的输入窗口。
8.1 点开文件，和运行文件，是两件事
点左侧hello.py，是让编辑器把文件内容显示出来；按保存，是把改动写回磁盘；执行程序，则需要解释器读取并运行代码。
这三步不要混在一起：
| 你做的动作 | 现在发生了什么 |
|---|---|
点开hello.py | 在编辑区查看或修改内容 |
按Ctrl + S或Command + S | 保存文件改动 |
| 后续使用 Python 运行 | 执行代码，产生输出或报错 |
因此，本篇还没看到“大家好”的终端输出是正常的。我们还没带着大家配置并执行 Python。
8.2 再检查一次：当前打开的是本地文件吗？
现在我们没有做远程连接。
通过左侧文件的“在文件管理器中显示”，你应该能回到自己电脑上的yolo-study。
等后面学习服务器时，我们会专门区分本地目录和远程目录，文件不能因为名字相同就当成同一份。今天先把本地操作做好。
9. 跟着做时，几个容易遇到的问题
9.1 左边只看到 images，看不到外层 yolo-study
可能打开的是图片文件夹。
重新执行“文件 → 打开文件夹”，选中直接包含images的外层yolo-study。
再检查hello.py和notes.txt的位置，按本文目录树对齐。
9.2 顶部显示 Untitled，没有 hello.py
这通常表示当前内容还没有按正式文件名保存。
使用“文件 → 另存为 / File → Save As”，选择自己的yolo-study，文件名填写hello.py。保存后核对完整扩展名与实际位置。
如果原位置已经有同名文件，先查看内容，确认哪份需要保留，不要直接覆盖。
9.3 重新打开后，找不到刚才的改动
先确认刚才按过保存，再检查是不是打开了另一份同名文件。
在左侧文件上右键，通过文件管理器显示它的位置。别只看标签上的名字。
9.4 没有看到运行按钮，或者点了以后提示配置环境
本篇先完成文件和编辑器操作。运行入口还涉及 Python 插件与解释器，后面的环境篇会走完整流程。
现在先检查本篇应留下的三个文件是否都存在。运行按钮的样式不作为本篇是否完成的判断标准。
9.5 我的界面和图片不一样
主题、语言、版本和已安装扩展都会影响界面。
我们现在操作的是本地学习目录。按菜单名称、区域和自己的文件位置核对。
10. 把前三篇连起来，自己检查一次
先关闭当前文件标签，再试着完成：
- 从左侧打开
images/bus.jpg，确认是第 2 篇复制的图片。 - 打开
hello.py，确认两行代码保存着。 - 打开
notes.txt，确认自己的目标、系统和实际目录已经写下。 - 在文件管理器里找到这几个文件，说明它们为什么处在不同层级。
- 指出编辑区、终端和命令面板分别在哪里。
然后在notes.txt最后增加一句：
我已经能自己找到图片、代码和学习记录。保存，关闭，再重新打开核对。
到这里，前三篇就连起来了：第一篇想清楚目标，第二篇找到并整理文件，第三篇用编辑器把自己的内容保存下来。
这几步以后会反复用到。接下来我们进入终端操作，再逐渐准备 Python 环境，把保存的代码真正运行起来。🚀
上一篇：基础篇 02｜文件、文件夹和路径
下一篇：基础篇 04｜第一次使用终端
