正文：

在开发或日常使用中，我们经常需要测试网络的上传、下载速度以及延迟情况。虽然市面上有许多在线测速工具，但通过Python编程实现网络测速可以更灵活地集成到自动化脚本或项目中。speedtest-cli 是一个基于Python的命令行工具，能够调用Speedtest.net的服务器进行网络测速，无需浏览器即可获取详细的网络性能数据。

1. 安装speedtest-cli

安装speedtest-cli非常简单，可以通过pip直接安装：

pip install speedtest-cli

如果你使用的是Python 3，可能需要明确指定pip3：

pip3 install speedtest-cli

安装完成后，可以通过以下命令验证是否安装成功：

speedtest-cli --version

如果输出版本号（如 2.1.3），说明安装成功。

2. 基本测速命令

speedtest-cli 提供了多种测速选项，以下是几个常用命令：

测试下载速度：

speedtest-cli --no-upload

此命令仅测试下载速度，适合仅关注下载性能的场景。

测试上传速度：

speedtest-cli --no-download

此命令仅测试上传速度，适合检查网络的上传带宽。

完整测速（默认）：

speedtest-cli

默认情况下，speedtest-cli 会测试下载、上传速度以及延迟（Ping值），并输出类似以下结果：

Retrieving speedtest.net configuration... Testing from YourISP (123.45.67.89)... Retrieving speedtest.net server list... Selecting best server based on ping... Hosted by Example Server (City) [10.00 km]: 15.234 ms Testing download speed................................................................................ Download: 85.64 Mbit/s Testing upload speed................................................................................ Upload: 22.18 Mbit/s

3. 进阶功能

指定测速服务器

默认情况下，speedtest-cli 会自动选择最近的服务器，但你也可以手动指定服务器ID进行测试。首先，列出可用服务器：

speedtest-cli --list

输出会显示服务器ID及其位置，例如：

12345) Example Server (City, Country) [10.00 km] 67890) Another Server (City, Country) [50.00 km]

然后，通过 --server 参数指定服务器ID：

speedtest-cli --server 12345

以JSON格式输出结果

如果需要将测速结果用于数据分析或日志记录，可以输出JSON格式：

speedtest-cli --json

输出示例：

json { "download": 85640000, "upload": 22180000, "ping": 15.234, "server": { "name": "Example Server", "distance": 10.00 } }

4. 在Python脚本中使用

除了命令行，speedtest-cli 还支持通过Python脚本调用。以下是一个简单的示例：

import speedtest  

def test_speed():  
    st = speedtest.Speedtest()  
    st.get_best_server()  
    download_speed = st.download() / 10**6  # 转换为Mbps  
    upload_speed = st.upload() / 10**6  
    ping = st.results.ping  

    print(f"Download: {download_speed:.2f} Mbps")  
    print(f"Upload: {upload_speed:.2f} Mbps")  
    print(f"Ping: {ping:.2f} ms")  

if __name__ == "__main__":  
    test_speed()  

运行脚本后，会输出与命令行类似的结果，但可以进一步扩展为自动化测试或监控工具。

5. 常见问题

测速结果不准确？

• 确保没有其他程序占用大量带宽。
• 尝试更换服务器（使用 --list 和 --server 参数）。

命令无法运行？

• 检查是否安装正确，尝试重新安装：pip install --upgrade speedtest-cli。
• 确保Python环境变量配置正确。

如何测试内网速度？

speedtest-cli 仅支持公网测速，内网测速需使用其他工具（如iperf）。