使用和安装 `got` HTTP请求库的教程

2026-01-17 08:20:19作者：裘旻烁

本教程将指导您了解并安装got，一个由Sindre Sorhus维护的人性化且强大的Node.js HTTP请求库。

1. 项目目录结构及介绍

在got仓库中，主要的目录结构如下：

src：源代码文件夹，包含核心的模块实现。
- index.ts：主入口点，定义了库的主要接口。
examples：示例代码，展示了如何使用库的不同功能。
test：单元测试文件，确保库的功能正常运行。
package.json：npm包定义文件，包含了版本信息、依赖项和可执行脚本。
README.md：项目的说明文件，提供了快速入门和API参考。

2. 项目的启动文件介绍

got作为一个Node.js库，通常不是作为独立的应用程序运行。而是通过其他Node.js项目导入和使用它的函数来发起HTTP请求。例如，在你的项目中，你可以这样引入和使用got：

const got = require('got');

(async () => {
    const response = await got('https://api.example.com');
    console.log(response.body);
})();

这里的require('got')就是导入库，然后你可以调用got的各种方法发起HTTP请求。

3. 项目的配置文件介绍

got没有传统的配置文件，而是通过选项对象传递配置到请求函数。例如，设置超时时间、自定义代理或者添加请求头：

const got = require('got');

await got('https://api.example.com', {
    timeout: 5000, // 设置5秒超时
    agent: { http: new HttpAgent(), https: newHttpsAgent() }, // 自定义http/https代理
    headers: {
        'User-Agent': 'My User Agent' // 添加自定义User-Agent
    }
});