jq Commands Guía rápida

JSON processor

What this cheat sheet is for

This jq commands reference helps you complete common developer tasks quickly and avoid repeated trial-and-error when working under deadlines.

When you need a reliable command or pattern during debugging and incident response.
When you are implementing a feature and want a known-good syntax example immediately.
When onboarding teammates and documenting repeatable workflows for daily use.
When reviewing pull requests and verifying that command usage follows best practices.

Parse JSON

jq '.key' file.json
jq '.data[0]' file.json
jq '.users[] | .name' file.json

Filter

jq '.[] | select(.age > 18)' file.json
jq 'map(select(.active == true))' file.json

Transform

jq '{ name: .fullName, age: .userAge }' file.json

Common mistakes / Errores comunes

People often copy a command or pattern without adapting placeholders, which can break production workflows unexpectedly.
It is easy to forget environment-specific differences, so always verify behavior in your shell, runtime, or API gateway before shipping.
Many errors come from skipping small validation steps, so test with realistic sample input before relying on the result.

Last updated: February 2026