手把手 1 / 4
从零到第一个 Python 脚本:终端第一课
没装过任何环境、没打开过终端的人,从这里上第一级台阶。全程不需要 Linux、不需要 GPU、不需要买任何东西——只要一台普通笔记本。
做完这件事,你手上会有
一台装好 Python 的电脑;会用命令行进文件夹、跑脚本、装包;第一次体会到「报错不慌」——读报错、定位、修好,是个机械流程。
站里另外三篇教程全部假设你会这些。这一篇把假设变成事实:每一步都是点得到的按钮、敲得出的命令,每一步都有一个「看到什么才算过」。
开工前
| 需要什么 | 版本 / 说明 |
|---|---|
目录
- 打开终端:用打字代替点鼠标
- 装 Python:记住勾 Add to PATH
- 第一个脚本:两行代码
- 报错不慌:读 traceback 是机械流程
- 装包:pip 是你的工具箱
- 画第一条曲线:f(x) = x²
- 终点也是起点:下一步去哪
打开终端:用打字代替点鼠标
终端(命令行)就是「用打字操作电脑」的方式,机器人圈的一切工具都住在这里。Windows 按 Win+R 输入 cmd 回车;macOS 用聚焦搜索(Cmd+空格)输入「终端」。先来两条最常用的:进文件夹用 cd,看文件用 dir(Windows)/ ls(macOS)。
cd Desktop
dir :: Windows 看当前文件夹的文件
ls # macOS 看当前文件夹的文件看到这个就算过
回车后列出的文件名里,有你桌面上认识的文件。
卡住了
| 症状 | 多半是这个原因 | 怎么办 |
|---|---|---|
| 命令打出来没反应,像没执行 | 输入法停在中文状态 | 切回英文(Shift 切换),终端只认英文命令 |
| cd Desktop 说找不到路径 | 系统语言不是中文,桌面文件夹叫 Desktop 之外的英文名 | 先只输入 cd 回车(回到家目录),再输入 dir / ls 看清名字 |
装 Python:记住勾 Add to PATH
打开浏览器去 python.org 官网下载安装包(Windows 选「Windows installer (64-bit)」)。Windows 安装界面第一个勾选项「Add python.exe to PATH」必须勾上——90% 的「python 不是内部或外部命令」都因为漏了它。装完关掉安装器。
python --version看到这个就算过
终端打印出 Python 3.11 或更高的版本号。
卡住了
| 症状 | 多半是这个原因 | 怎么办 |
|---|---|---|
| 提示「python 不是内部或外部命令」 | 安装时没勾 Add to PATH | 重新运行安装包,选 Modify,把 Add to PATH 勾上,一路下一步 |
| macOS 打印的是 Python 2.x | 系统自带的老版本 | 在 python.org 装新版后用 python3 --version 验证 |
第一个脚本:两行代码
在桌面新建一个文本文件,改名成 hello.py(不是 hello.txt)。用记事本打开,粘贴下面两行,保存。回到终端(应该还在 Desktop 目录),跑它。
# hello.py 的内容
print("hello, robot")
for i in range(3):
print("第", i, "步")
# 终端里执行
python hello.py看到这个就算过
打印出 hello,robot 和三行「第 x 步」。
卡住了
| 症状 | 多半是这个原因 | 怎么办 |
|---|---|---|
| 说找不到 hello.py | 文件名实际是 hello.py.txt(Windows 默认隐藏扩展名) | 在文件资源管理器打开「查看 → 显示 → 文件扩展名」,把 .txt 去掉 |
| SyntaxError: invalid character | 引号或冒号打成了中文全角 | 删掉重打,代码里的引号、冒号、括号都必须是英文半角 |
| IndentationError | for 下面的行没有缩进 | 第二行开头留 4 个空格 |
报错不慌:读 traceback 是机械流程
故意制造一个错:把 print 改成 prin,再跑一次。终端会打印一串红字(traceback)。读法只有两步:看最后一行(错是什么),看最上面第一行(错在哪)。修好再跑——把「报错→定位→修好」这个循环走顺,你就超过一半的初学者了。
prin("oops") # 故意的错
# 修好
print("fixed")看到这个就算过
能在一分钟内:说出错因(NameError: name 'prin' is not defined)→ 定位到那一行 → 改对 → 跑通。
卡住了
| 症状 | 多半是这个原因 | 怎么办 |
|---|---|---|
| 看不懂红字里在说什么 | 初见 traceback 觉得像灾难片 | 只看两个位置:最后一行是错因,箭头 ↑ 指的行号是出事地点。其他行暂时忽略 |
装包:pip 是你的工具箱
Python 世界装工具用 pip。装两个将来必用的:numpy(科学计算的底座)和 matplotlib(画图)。装完用一行命令验证它们真的进来了。
pip install numpy matplotlib
python -c "import numpy; print(numpy.__version__)"看到这个就算过
打印出 numpy 的版本号(2.x)。
卡住了
| 症状 | 多半是这个原因 | 怎么办 |
|---|---|---|
| pip 不是内部或外部命令 | PATH 问题或旧版 Python | 改用 python -m pip install numpy matplotlib |
| 下载很慢或超时 | 默认源在国外 | 换国内镜像:pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple |
画第一条曲线:f(x) = x²
新建 plot.py:用 numpy 造一串 x,算 y=x²,用 matplotlib 画出来。跑完弹出的窗口里那条抛物线,和站里 /math/grad/ 讲的抛物面是同一个形状——你的第一张「机器人调参曲线」。
# plot.py 的内容
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(-3, 3, 100)
y = x ** 2
plt.plot(x, y)
plt.title("f(x) = x^2")
plt.show()
python plot.py看到这个就算过
弹出窗口,一条对称的抛物线,标题正确。
卡住了
| 症状 | 多半是这个原因 | 怎么办 |
|---|---|---|
| 脚本跑完闪退,没弹窗 | 图形后端异常 | 把 plt.show() 前加 plt.savefig("out.png"),先拿到图片文件也能算过 |
| 中文标题显示方块 | 默认字体不含中文 | 标题先用英文,字体配置是后面才需要折腾的事 |
终点也是起点:下一步去哪
到此你已经具备:终端、Python、报错处理、装包、画图。下一步是站里的 gazebo-arm 教程,但它需要 Linux——那是另一个量级的决定(装 Ubuntu 双系统或 WSL2)。今天不用做,只需知道顺序:先在本机把 Python 玩熟(改改 plot.py 画 x³、sin(x)),再动 Linux。
看到这个就算过
能说出自己下一步要做什么、需要什么前置。
卡住了
| 症状 | 多半是这个原因 | 怎么办 |
|---|---|---|
| 不知道下一步选双系统还是 WSL2 | 两个都还没了解过 | 都先别做。把本篇的东西再独立重复一遍,能不看本页全部跑通,再去看 gazebo-arm 的「开工前」清单 |
验收清单
不看界面、不翻聊天记录,能独立完成下面这几条,这篇教程才算真的过了。
- 不看本页:打开终端 → cd 进任意文件夹 → 列出文件 → 跑一个自己的 .py
- 拿到一个 NameError,能在 1 分钟内说出错因、定位、修好
- pip 装一个新包(比如 pandas),验证 import 成功
- 把 plot.py 改成画 sin(x),能解释 x 轴和 y 轴各是什么