Декодирование JSON с использованием json.Unmarshal vs json.NewDecoder.Decode

Я разрабатываю клиент API, в котором мне нужно кодировать полезную нагрузку JSON по запросу и декодировать тело JSON из ответа.

Я прочитал исходный код из нескольких библиотек и из того, что я видел, у меня есть две возможности кодирования и декодирования строки JSON.

Использовать json.Unmarshalпередачу всей строки ответа

data, err := ioutil.ReadAll(resp.Body)
if err == nil && data != nil {
    err = json.Unmarshal(data, value)
}

или используя json.NewDecoder.Decode

err = json.NewDecoder(resp.Body).Decode(value)

В моем случае, когда речь идет о HTTP-ответах, которые реализуются io.Reader, вторая версия, похоже, требует меньше кода, но, поскольку я видел оба, я задаюсь вопросом, есть ли какое-либо предпочтение, следует ли мне использовать решение, а не другое.

Более того, принятый ответ на этот вопрос говорит

Пожалуйста, используйте json.Decoderвместо json.Unmarshal.

но это не упомянуло причину. Должен ли я действительно избегать использования json.Unmarshal?

Это действительно зависит от вашего вклада. Если вы посмотрите на реализацию Decodeметода json.Decoder, он буферизует все значение JSON в памяти перед тем, как демонтировать его в значение Go. Так что в большинстве случаев он не будет более эффективным в использовании памяти (хотя это может легко измениться в будущей версии языка).

Итак, лучшее эмпирическое правило таково:

• Используйте, json.Decoderесли ваши данные поступают из io.Readerпотока, или вам нужно декодировать несколько значений из потока данных.
• Используйте, json.Unmarshalесли у вас уже есть данные JSON в памяти.

В случае чтения из HTTP-запроса я бы выбрал, json.Decoderпоскольку вы, очевидно, читаете из потока.