小技巧
Small programming tricks

原始链接: https://will-keleher.com/posts/small-programming-tricks-matter/

工程效率通常取决于“高杠杆小技巧”——即那些能简化复杂任务,且无需过多思考成本的实用知识。无论是诸如用于命令行历史记录的 `fzf` 等终端快捷方式,还是像 `git log -S`(“鹤嘴锄”搜索)这样具体的 `git` 指令,亦或是通过 `https.Agent` 来降低 Node.js 中的延迟,这些微小的优化积累起来,能显著加快日常工作流。 除技术技巧外,这一理念也适用于公司内部的“部落知识”,例如清楚地知道哪份文档、哪位同事或哪个内部工具能解决反复出现的问题。由于这些技巧门槛低且效果显著,它们非常适合在工程团队内部进行分享。 作者建议资深工程师每天分享一个这样的“小技巧”。这种频率既不会让同事感到负担,又能培养持续改进和协作解决问题的文化。即使某个技巧大多数人已知,那一个新颖的招式也可能为他人节省时间,并激发有价值的技术讨论。归根结底,这些点滴知识是一个高效且强悍的工程团队的基石。

抱歉。
相关文章

原文

Day to day, I think a surprising amount of engineering productivity comes from small nuggets of knowledge: being aware that a language feature exists; knowing that an unexplained tcp delay is probably related to the TCP_NO_DELAY setting and Nagle’s algorithm; knowing the right git incantation to get out of a pickle; or knowing a trick with sed to rewrite a file.

In one sense, this is self-evident: anything you know is going to be made up of smaller pieces of knowledge. Of course those smaller pieces of knowledge matter.

But I think there are some nuggets of knowledge that are particularly valuable and don’t require a lot of supporting mental infrastructure. You don’t need to know any python to use python3 -m http.server to start a simple server in a directory, but it might still make your work marginally easier. Let me share a few examples:

  • You probably know that ctrl + r allows searching your terminal’s command history, but if you install fzf, you can set it up so that ctrl + r does a fuzzy search. If you want even more power, atuin replaces your shell history with a searchable SQLite database. per-directory-history lets you switch back and forth between searching for commands that have been run in a specific directory or searching all previous commands. Finally, you can configure how much history to store: stackoverflow question.
  • You can SELECT without a FROM. This can be useful for testing out how a function in your database actually works or reminding yourself how SELECT TRUE <> NULL works.
  • PostgresSQL and MySQL both support explain analyze which will actually run the query you’re trying to optimize and give you a ton more information about its performance.
  • In regular expressions, \b, the word boundary assertion, makes it easy to look for the beginnings or ends of words.
  • You can use logarithms with metrics to get a sense of the distribution of values for a field you’re interested in:
    const bucket = Math.floor(Math.log10(userInGroupCount))
    metrics.increment("my_metric", { bucket });
    
  • Modern JS now supports Array.flatMap, Object.entries, and Promise.withResolvers.
  • In NodeJS, you can keep a connection open to an external resource by creating an https.Agent and then providing it to your http requests: fetch(url, {method, agent}). This can have a dramatic impact on latency.
  • git log -S pattern (”git pickaxe”) can give you all commits that added or removed a string in a codebase. It’s amazingly useful especially with older codebases! (git log -G pattern is similar, but will also show when that line was moved)
  • Similar to cd -, you can use git checkout - to check out your previous HEAD.
  • You probably don’t need find. A lot of find commands can be replaced with globs like **/*.md. Most shells support this out of the box, but with bash, you need to turn this on with shopt -s globstar.
  • In a similar vein, most folks will probably want to use rg (ripgrep) rather than grep, ack, or ag.
  • zsh’s advanced autocompletion features aren’t turned on by default:
    if type brew &>/dev/null; then
        FPATH="$(brew --prefix)/share/zsh/site-functions:${FPATH}"
    fi
    autoload -Uz compinit
    compinit
    

You might have already known all of these things! Or you might work in a domain that makes all of these little tricks totally useless. Even if this particular set of tricks isn’t useful for you, I bet you have your own stash of tricks that you’ve accumulated over the years that makes your work easier.

At a company, I think even more knowledge tends to be this sort of small high-leverage nugget:

  • To debug $PROBLEM, use $DATA_SOURCE.
  • $PERSON knows a ton about $AREA and they’re happy to help if you get stuck
  • There are good docs about $HARD_THING $OVER_HERE.
  • When $THING happens, it means we should manually scale out.
  • To do a rolling restart of a service, run $THIS_COMMAND.
  • This $UTIL makes $THAT_PROBLEM easy to script.

At a previous company, I shared a trick on slack every day with the engineering team, both technical and company-specific, and folks found them pretty useful. Even if you knew 9/10 tricks, that 10th doc or technique might save you some time! And one trick per day was the right number to avoid overwhelming people with knowledge, and it could occasionally spark useful discussion. If you’re a more senior engineer at your company, you might think about doing something similar.

联系我们 contact @ memedata.com