PonyTechLab0. 你要先知道：jtop 是什么
jtop 是终端里的 Jetson “任务管理器”
它来自 jetson-stats（简称 jstats）
能看：CPU/GPU/EMC/温度/功耗/风扇/NVENC/NVDEC/进程资源占用等
1. 准备工作（确认系统 & 网络）
1.1 确认你是 Jetson 系统
cat /etc/nv_tegra_release
能看到 NVIDIA L4T/JetPack 字样基本就对了。
1.2 确认 Python3 / pip3 可用
python3 --version pip3 --version
1.3 更新 apt 源（强烈建议）
sudo apt update sudo apt upgrade -y
如果你在国内网络环境，apt/pip 可能慢，后面我也给你镜像方案。
2. 安装方式 A（推荐：pip 官方安装）
2.1 安装 pip3（如果没装）
sudo apt install -y python3-pip
2.2 安装 jetson-stats（jtop）
关键点：用 sudo pip3 装
sudo pip3 install -U jetson-stats
安装完成后通常会提示你需要 reboot。
2.3 重启（必须做）
sudo reboot
3. 验证安装是否成功
重启后执行：
3.1 检查版本
jtop --version
3.2 运行 jtop
jtop
如果你是通过 ssh 连接，也没问题，jtop 是纯 TUI。
4. 常见报错与解决（非常常见，直接照抄修）
4.1 jtop: command not found
说明 PATH 没找到，通常是装到 /usr/local/bin 但没刷新，或安装失败。
先确认是否装上：
sudo pip3 show jetson-stats
如果没装上，重装：
sudo pip3 install -U jetson-statssudo reboot
4.2 运行后提示权限不够 / 读不到硬件
先尝试：
sudo jtop
如果 sudo 才正常，说明你的用户权限不足（可选优化：加组权限）。
4.3 ModuleNotFoundError / Python 包冲突
建议用下面方式重装（最干净）：
sudo pip3 uninstall -y jetson-stats sudo pip3 install -U jetson-stats sudo reboot
4.4 pip 下载非常慢（国内常见）
临时使用清华源：
sudo pip3 install -U jetson-stats -i https://pypi.tuna.tsinghua.edu.cn/simple
长期配置（可选）：
mkdir -p ~/.pipcat > ~/.pip/pip.conf <<'EOF'[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simpletimeout = 60 EOF
5. jtop 界面怎么用（按键说明 + 关键指标）
进入 jtop 后，你会看到顶部状态栏 + 多页签。
5.1 常用快捷键
h：帮助q：退出1~6：切换页面（不同版本页数略有差异）p：功耗/性能模式（nvpmodel 相关）f：风扇控制（如果支持）r：刷新/重置某些统计（不同版本略不同）
5.2 你要重点看的指标
GPU：TensorRT/CUDA 是否真的跑在 GPU 上
EMC：内存带宽（Orin 很多瓶颈在这里）
温度：SOC/CPU/GPU，是否触发降频
功耗：是否在你期望的 nvpmodel 档位
风扇：是否按预期转速（避免热降频）
6. 进阶：设置高性能模式（Orin 常用）
说明：不同 JetPack 下 nvpmodel 档位编号不完全一样，你需要先查询你的板子有哪些档位。
6.1 查看可用功耗模式
sudo nvpmodel -q
会列出模式 ID 列表。
6.2 切换到某个模式（例：mode 0）
sudo nvpmodel -m 0
6.3 锁定最高频（适合跑性能测试）
sudo jetson_clocks
恢复动态频率（不同系统可能略不同）：
sudo jetson_clocks --restore
7. 进阶：风扇控制（如果你需要）
先看看风扇是否可控：
ls /sys/devices/pwm-fan/
常见操作方式（不同机型路径略变）：
7.1 切到手动模式（如果存在）
echo 0 | sudo tee /sys/devices/pwm-fan/target_pwm
7.2 设置风扇转速（0~255）
echo 200 | sudo tee /sys/devices/pwm-fan/target_pwm
备注：有的系统是
hwmon路径，如果你执行ls找不到，我可以根据你ls /sys/class/hwmon/输出告诉你哪个文件该改。
8. 自启动：开机自动高性能 + 风扇策略（可选但很实用）
如果你希望每次开机自动：
设置 nvpmodel
执行 jetson_clocks
设置风扇转速
8.1 写一个脚本
sudo mkdir -p /opt/jetson-tools sudo nano /opt/jetson-tools/perf.sh
粘贴：
#!/bin/bashsudo nvpmodel -m 0 sudo jetson_clocks# 可选：设置风扇（路径可能不同）# echo 200 > /sys/devices/pwm-fan/target_pwm
赋予可执行权限：
sudo chmod +x /opt/jetson-tools/perf.sh
8.2 配 systemd 服务
sudo nano /etc/systemd/system/jetson-perf.service
粘贴：
[Unit]Description=Jetson Performance SetupAfter=multi-user.target[Service]Type=oneshotExecStart=/opt/jetson-tools/perf.shRemainAfterExit=yes[Install]WantedBy=multi-user.target
启用并启动：
sudo systemctl daemon-reload sudo systemctl enable jetson-perf.service sudo systemctl start jetson-perf.service
查看状态：
systemctl status jetson-perf.service
9. 卸载（如果你要恢复）
sudo pip3 uninstall -y jetson-stats
10. 给你一条“最短成功路径”
sudo apt update && sudo apt upgrade -y sudo apt install -y python3-pip sudo pip3 install -U jetson-stats sudo reboot# 重启后jtop
