A huge part of programming in general is learning how to troubleshoot something, not just having someone else fix it for you. One of the basic ways to do that is by tracing. Not only can this help you figure out what your script is doing and how it’s doing it, but in the event that you need help from another person, posting the output can be beneficial to the person attempting to help.
(If your shell isn’t listed and you know how to enable tracing, comment below and I’ll add it to the table!)
Shell | How to enable tracing |
---|---|
Bash | set -x or set -o xtrace |
Fish | set fish_trace on |
sh | set -x |
Zsh | set -x or setopt xtrace |
Also, writing scripts in an IDE that supports your language. syntax highlighting can immediately tell you that you’re doing something wrong.
If an IDE isn’t an option and you’re using Bash or Sh, you can paste your script into https://www.shellcheck.net/
(Inspired by this post on /r/bash)
It’s basically doing step by step print lines for you. If you have easy access to a bash prompt here’s an example (for clarity, the lines leading with
$
are what I typed into the shell. The lines without are what is output’d):$ set -x $ echo `expr 10 + 20 ` ++ expr 10 + 20 + echo 30 30
$ set +x $ echo `expr 10 + 20 ` 30
You see how the first example broke down what happened bit by bit and the
+
noted the depth of interpretation for the line? This basically helps debug narly scripts … which if they’re narly enough … just rewrite them in a “proper” language.What’s that old google adage ( https://google.github.io/styleguide/shellguide.html )
Ohhh that’s nice! That’s genuinely super helpful! Never knew about this one, thanks!