机器人入行指南
实践/手把手/从零到第一个 Python 脚本:终端第一课

手把手 1 / 4

从零到第一个 Python 脚本:终端第一课

没装过任何环境、没打开过终端的人,从这里上第一级台阶。全程不需要 Linux、不需要 GPU、不需要买任何东西——只要一台普通笔记本。

约 1–2 h7 步零基础

数学:初中数学编程:零起点(本篇就是教这个)硬件:一台普通笔记本

做完这件事,你手上会有

一台装好 Python 的电脑;会用命令行进文件夹、跑脚本、装包;第一次体会到「报错不慌」——读报错、定位、修好,是个机械流程。

站里另外三篇教程全部假设你会这些。这一篇把假设变成事实:每一步都是点得到的按钮、敲得出的命令,每一步都有一个「看到什么才算过」。

开工前

需要什么版本 / 说明

目录

  1. 打开终端:用打字代替点鼠标
  2. 装 Python:记住勾 Add to PATH
  3. 第一个脚本:两行代码
  4. 报错不慌:读 traceback 是机械流程
  5. 装包:pip 是你的工具箱
  6. 画第一条曲线:f(x) = x²
  7. 终点也是起点:下一步去哪
终端cd / dir / ls10 min装 Python勾 Add to PATH15 min第一个脚本hello.py 跑通10 min装包 pipnumpy + matplotlib10 min第一条曲线画出 f(x)=x²15 min第 0 篇的路线:五个环节每个都有「看到什么算过」——跑不通就是那一步错了,不用猜
01

打开终端:用打字代替点鼠标

终端(命令行)就是「用打字操作电脑」的方式,机器人圈的一切工具都住在这里。Windows 按 Win+R 输入 cmd 回车;macOS 用聚焦搜索(Cmd+空格)输入「终端」。先来两条最常用的:进文件夹用 cd,看文件用 dir(Windows)/ ls(macOS)。

终端 / 代码
cd Desktop
dir     :: Windows 看当前文件夹的文件
ls      # macOS 看当前文件夹的文件

看到这个就算过

回车后列出的文件名里,有你桌面上认识的文件。

卡住了

症状多半是这个原因怎么办
命令打出来没反应,像没执行输入法停在中文状态切回英文(Shift 切换),终端只认英文命令
cd Desktop 说找不到路径系统语言不是中文,桌面文件夹叫 Desktop 之外的英文名先只输入 cd 回车(回到家目录),再输入 dir / ls 看清名字
02

装 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 验证
03

第一个脚本:两行代码

在桌面新建一个文本文件,改名成 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引号或冒号打成了中文全角删掉重打,代码里的引号、冒号、括号都必须是英文半角
IndentationErrorfor 下面的行没有缩进第二行开头留 4 个空格
04

报错不慌:读 traceback 是机械流程

故意制造一个错:把 print 改成 prin,再跑一次。终端会打印一串红字(traceback)。读法只有两步:看最后一行(错是什么),看最上面第一行(错在哪)。修好再跑——把「报错→定位→修好」这个循环走顺,你就超过一半的初学者了。

终端 / 代码
prin("oops")   # 故意的错

# 修好
print("fixed")

看到这个就算过

能在一分钟内:说出错因(NameError: name 'prin' is not defined)→ 定位到那一行 → 改对 → 跑通。

卡住了

症状多半是这个原因怎么办
看不懂红字里在说什么初见 traceback 觉得像灾难片只看两个位置:最后一行是错因,箭头 ↑ 指的行号是出事地点。其他行暂时忽略
05

装包: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
06

画第一条曲线: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"),先拿到图片文件也能算过
中文标题显示方块默认字体不含中文标题先用英文,字体配置是后面才需要折腾的事
07

终点也是起点:下一步去哪

到此你已经具备:终端、Python、报错处理、装包、画图。下一步是站里的 gazebo-arm 教程,但它需要 Linux——那是另一个量级的决定(装 Ubuntu 双系统或 WSL2)。今天不用做,只需知道顺序:先在本机把 Python 玩熟(改改 plot.py 画 x³、sin(x)),再动 Linux。

看到这个就算过

能说出自己下一步要做什么、需要什么前置。

卡住了

症状多半是这个原因怎么办
不知道下一步选双系统还是 WSL2两个都还没了解过都先别做。把本篇的东西再独立重复一遍,能不看本页全部跑通,再去看 gazebo-arm 的「开工前」清单

验收清单

不看界面、不翻聊天记录,能独立完成下面这几条,这篇教程才算真的过了。

接着学

其他教程