Building a Zsh Environment from Scratch

Most Zsh tutorials out there share a common flaw: they tell you "Oh My Zsh is great" or "Just install this plugin for convenience," then hand you a bunch of copy-paste configs. When you actually want to understand why, how, and whether it can be faster, those tutorials usually stop right there.

This one is different. Here's what we're going to do:

Understand Zsh's core mechanisms—not just "how to use it," but "why it's designed this way"
Know exactly what every line of configuration does
Use Zim to make your terminal faster than everyone else's

If you're tired of "magic configs" and want to truly take control of your shell, read on.

Part 1: Zsh Core Mechanisms

1.1 How Zsh and Bash Are Actually Different

Many people switch to Zsh just because it has "more features," but that's only scratching the surface. Zsh's real advantage lies in its modularity—each subsystem is independent and can be enhanced separately, rather than being a jumbled mess.

Let's start with the startup process and compare the two:

Bash: Three files with mixed responsibilities

{"type":"excalidraw/clipboard","elements":[{"id":"euyjRWrBL-0OcGNYuKKsK","type":"rectangle","x":-1750.575121001492,"y":740.3782202813804,"width":227.1484375,"height":90,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0U","roundness":null,"seed":230727812,"version":6,"versionNonce":1395555076,"isDeleted":false,"boundElements":[{"type":"text","id":"-TmPm4bYjs46HSvghTWIo"},{"id":"ak3CAWm7MI1fGTFDKQOp6","type":"arrow"}],"updated":1776764887296,"link":null,"locked":false},{"id":"-TmPm4bYjs46HSvghTWIo","type":"text","x":-1721.9708882134062,"y":760.3782202813804,"width":169.93997192382812,"height":50,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0V","roundness":null,"seed":1768026116,"version":7,"versionNonce":82400388,"isDeleted":false,"boundElements":[],"updated":1776764895393,"link":null,"locked":false,"text":"/etc/profile\nSystem-level · Login shell","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"euyjRWrBL-0OcGNYuKKsK","originalText":"/etc/profile\n系统级 · 登录 shell","autoResize":true,"lineHeight":1.25},{"id":"xObWtoWkKtLhUZI5Zpjfk","type":"rectangle","x":-1473.426683501492,"y":740.3782202813804,"width":227.1484375,"height":90,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0W","roundness":null,"seed":1932349316,"version":7,"versionNonce":691042948,"isDeleted":false,"boundElements":[{"type":"text","id":"4GCnbh2eWNxKIck4pYKuE"},{"id":"ak3CAWm7MI1fGTFDKQOp6","type":"arrow"},{"id":"eHhjp3g585QaIsvvZSAg6","type":"arrow"}],"updated":1776764887296,"link":null,"locked":false},{"id":"4GCnbh2eWNxKIck4pYKuE","type":"text","x":-1444.8224507134062,"y":760.3782202813804,"width":169.93997192382812,"height":50,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0X","roundness":null,"seed":2069937924,"version":12,"versionNonce":44667012,"isDeleted":false,"boundElements":[],"updated":1776764899414,"link":null,"locked":false,"text":"~/.bash_profile\nUser-level · Login shell","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"xObWtoWkKtLhUZI5Zpjfk","originalText":"~/.bash_profile\n用户级 · 登录 shell","autoResize":true,"lineHeight":1.25},{"id":"AB463fHk4MJ6wRY1c7m2P","type":"rectangle","x":-1196.1187143286268,"y":740.2133708860863,"width":247.1484375,"height":90,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0Y","roundness":null,"seed":444219012,"version":8,"versionNonce":379207556,"isDeleted":false,"boundElements":[{"type":"text","id":"bvFeYldzrY-2Bt1yjHsdz"},{"id":"eHhjp3g585QaIsvvZSAg6","type":"arrow"},{"id":"nhpC0G3RlhEnEKEzwyS5q","type":"arrow"}],"updated":1776764900822,"link":null,"locked":false},{"id":"bvFeYldzrY-2Bt1yjHsdz","type":"text","x":-1167.5144815405408,"y":760.2133708860863,"width":189.93997192382812,"height":50,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0Z","roundness":null,"seed":691523076,"version":11,"versionNonce":837480124,"isDeleted":false,"boundElements":[],"updated":1776764903152,"link":null,"locked":false,"text":"~/.bashrc\nUser-level · Interactive shell","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"AB463fHk4MJ6wRY1c7m2P","originalText":"~/.bashrc\n用户级 · 交互式 shell","autoResize":true,"lineHeight":1.25},{"id":"SW8I3ru2oBz1Rw_bnuIyA","type":"rectangle","x":-899.1298085014921,"y":762.8782202813804,"width":66.22688293457031,"height":45,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0a","roundness":{"type":3},"seed":949448068,"version":6,"versionNonce":65972612,"isDeleted":false,"boundElements":[{"type":"text","id":"IuFs1zN5XFRT_BGKvVvaZ"},{"id":"nhpC0G3RlhEnEKEzwyS5q","type":"arrow"}],"updated":1776764887296,"link":null,"locked":false},{"id":"IuFs1zN5XFRT_BGKvVvaZ","type":"text","x":-886.016367034207,"y":772.8782202813804,"width":40,"height":25,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0b","roundness":null,"seed":165092612,"version":6,"versionNonce":1993187516,"isDeleted":false,"boundElements":[],"updated":1776764887296,"link":null,"locked":false,"text":"Done","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"SW8I3ru2oBz1Rw_bnuIyA","originalText":"完成","autoResize":true,"lineHeight":1.25},{"id":"ak3CAWm7MI1fGTFDKQOp6","type":"arrow","x":-1522.9271210014922,"y":785.3782202813804,"width":45.00000000000003,"height":0,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0c","roundness":{"type":2},"seed":108321924,"version":7,"versionNonce":1592187140,"isDeleted":false,"boundElements":[],"updated":1776764887296,"link":null,"locked":false,"points":[[0,0],[24.50000000000003,0],[45.00000000000003,0]],"startBinding":{"elementId":"euyjRWrBL-0OcGNYuKKsK","mode":"orbit","fixedPoint":[0.9999980739466896,0.5001]},"endBinding":{"elementId":"xObWtoWkKtLhUZI5Zpjfk","mode":"orbit","fixedPoint":[-0.017611556319862318,0.5001]},"startArrowhead":null,"endArrowhead":"arrow","elbowed":false},{"id":"eHhjp3g585QaIsvvZSAg6","type":"arrow","x":-1240.278246001492,"y":785.3850603263804,"width":38.15953167286534,"height":0.14795762691665004,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0d","roundness":{"type":2},"seed":942582788,"version":8,"versionNonce":460009092,"isDeleted":false,"boundElements":[],"updated":1776764900824,"link":null,"locked":false,"points":[[0,0],[19.000125000000025,-0.006840044999989914],[38.15953167286534,-0.14795762691665004]],"startBinding":{"elementId":"xObWtoWkKtLhUZI5Zpjfk","mode":"orbit","fixedPoint":[1.000000550300946,0.5001]},"endBinding":{"elementId":"AB463fHk4MJ6wRY1c7m2P","mode":"orbit","fixedPoint":[-0.016184099889362945,0.5001]},"startArrowhead":null,"endArrowhead":"arrow","elbowed":false,"moveMidPointsWithElement":false},{"id":"nhpC0G3RlhEnEKEzwyS5q","type":"arrow","x":-942.9702768286268,"y":785.2600169184551,"width":37.840468327134545,"height":0.4911223841336323,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b0e","roundness":{"type":2},"seed":1090685828,"version":8,"versionNonce":1049280004,"isDeleted":false,"boundElements":[],"updated":1776764900824,"link":null,"locked":false,"points":[[0,0],[18.84015582713471,0.11820336292532829],[37.840468327134545,0.4911223841336323]],"startBinding":{"elementId":"AB463fHk4MJ6wRY1c7m2P","mode":"orbit","fixedPoint":[0.9999987355776832,0.5001]},"endBinding":{"elementId":"SW8I3ru2oBz1Rw_bnuIyA","mode":"orbit","fixedPoint":[-0.05283824853205252,0.5093777777777777]},"startArrowhead":null,"endArrowhead":"arrow","elbowed":false,"moveMidPointsWithElement":false}],"files":{}}

Zsh: More files, but each does one thing

{"type":"excalidraw/clipboard","elements":[{"id":"J0r136imjWuTBOv-WZZ8S","type":"rectangle","x":-2351.4021323851143,"y":228.40952074396495,"width":200.5703125,"height":90,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4J","roundness":null,"seed":1090474940,"version":17,"versionNonce":1893231548,"isDeleted":false,"boundElements":[{"type":"text","id":"ruiMdJN0GdZDrgxt9R9a3"},{"id":"Em6_EDQsVgZuEmxiLBHp5","type":"arrow"}],"updated":1776768068864,"link":null,"locked":false},{"id":"ruiMdJN0GdZDrgxt9R9a3","type":"text","x":-2325.9369605711495,"y":248.40952074396495,"width":149.6399688720703,"height":50,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4K","roundness":null,"seed":701856828,"version":21,"versionNonce":227160892,"isDeleted":false,"boundElements":[],"updated":1776768068164,"link":null,"locked":false,"text":"~/.zshenv\nLoaded by any zsh","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"J0r136imjWuTBOv-WZZ8S","originalText":"~/.zshenv\n任何 zsh 都加载","autoResize":true,"lineHeight":1.25},{"id":"cE_NunvyqKyhz7PVgjZYB","type":"rectangle","x":-2100.8318198851143,"y":228.40952074396495,"width":167.7578125,"height":90,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4L","roundness":null,"seed":1456641212,"version":15,"versionNonce":1666237956,"isDeleted":false,"boundElements":[{"type":"text","id":"o3m7QBNq_cgwjlVjrzeTu"},{"id":"Em6_EDQsVgZuEmxiLBHp5","type":"arrow"},{"id":"w8G93gSYC8-x-p3PAByqX","type":"arrow"}],"updated":1776768062021,"link":null,"locked":false},{"id":"o3m7QBNq_cgwjlVjrzeTu","type":"text","x":-2071.9228995970284,"y":248.40952074396495,"width":109.93997192382812,"height":50,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4M","roundness":null,"seed":93887804,"version":18,"versionNonce":886138244,"isDeleted":false,"boundElements":[],"updated":1776768062021,"link":null,"locked":false,"text":"~/.zprofile\nLogin shell only","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"cE_NunvyqKyhz7PVgjZYB","originalText":"~/.zprofile\n仅登录 shell","autoResize":true,"lineHeight":1.25},{"id":"nfeJM6T69uI2f4cob5-9o","type":"rectangle","x":-1883.0740073851143,"y":228.5796878616879,"width":187.7578125,"height":90,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4N","roundness":null,"seed":1871287740,"version":19,"versionNonce":88452284,"isDeleted":false,"boundElements":[{"type":"text","id":"ZW-apF3qaFPqJVdT8UCEq"},{"id":"w8G93gSYC8-x-p3PAByqX","type":"arrow"},{"id":"GzjgOVrvVdx2Je7GK5PH8","type":"arrow"}],"updated":1776768071814,"link":null,"locked":false},{"id":"ZW-apF3qaFPqJVdT8UCEq","type":"text","x":-1854.1650870970284,"y":248.5796878616879,"width":129.93997192382812,"height":50,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4O","roundness":null,"seed":1372028476,"version":27,"versionNonce":636007740,"isDeleted":false,"boundElements":[],"updated":1776768073213,"link":null,"locked":false,"text":"~/.zshrc\nInteractive shell only","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"nfeJM6T69uI2f4cob5-9o","originalText":"~/.zshrc\n仅交互式 shell","autoResize":true,"lineHeight":1.25},{"id":"-LgUSNJNzU_xj31-hK5sC","type":"rectangle","x":-1645.3161948851139,"y":228.5690524168303,"width":160,"height":90,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4P","roundness":null,"seed":1966364348,"version":18,"versionNonce":34317316,"isDeleted":false,"boundElements":[{"type":"text","id":"r-sM-U0VZTBDkMjLwkGtt"},{"id":"GzjgOVrvVdx2Je7GK5PH8","type":"arrow"},{"id":"-sEXe4xIC8EoiXZYYLPEU","type":"arrow"}],"updated":1776768062021,"link":null,"locked":false},{"id":"r-sM-U0VZTBDkMjLwkGtt","type":"text","x":-1615.3161948851139,"y":248.5690524168303,"width":100,"height":50,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4Q","roundness":null,"seed":913448764,"version":23,"versionNonce":880837508,"isDeleted":false,"boundElements":[],"updated":1776768062021,"link":null,"locked":false,"text":"~/.zlogin\nAfter login","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"-LgUSNJNzU_xj31-hK5sC","originalText":"~/.zlogin\n登录完成后","autoResize":true,"lineHeight":1.25},{"id":"KOdVI5yooWwi0AnYvairG","type":"rectangle","x":-1435.3161948851139,"y":250.90952074396495,"width":66.22688293457031,"height":45,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4R","roundness":{"type":3},"seed":232970172,"version":16,"versionNonce":338522884,"isDeleted":false,"boundElements":[{"type":"text","id":"xUOy7DFPngtebaiq18U3m"},{"id":"-sEXe4xIC8EoiXZYYLPEU","type":"arrow"}],"updated":1776768062021,"link":null,"locked":false},{"id":"xUOy7DFPngtebaiq18U3m","type":"text","x":-1422.2027534178287,"y":260.90952074396495,"width":40,"height":25,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4S","roundness":null,"seed":396918844,"version":14,"versionNonce":1603302020,"isDeleted":false,"boundElements":[],"updated":1776768062021,"link":null,"locked":false,"text":"Done","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"KOdVI5yooWwi0AnYvairG","originalText":"完成","autoResize":true,"lineHeight":1.25},{"id":"Em6_EDQsVgZuEmxiLBHp5","type":"arrow","x":-2144.8318198851143,"y":273.41471897296645,"width":38.000000000000455,"height":0.014331562498455241,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4T","roundness":{"type":2},"seed":463804604,"version":17,"versionNonce":1432846852,"isDeleted":false,"boundElements":[],"updated":1776768062021,"link":null,"locked":false,"points":[[0,0],[18.99968750000062,-0.012038116501571494],[38.000000000000455,0.0022934459968837473]],"startBinding":{"elementId":"J0r136imjWuTBOv-WZZ8S","mode":"orbit","fixedPoint":[0.9999984419428972,0.5001]},"endBinding":{"elementId":"cE_NunvyqKyhz7PVgjZYB","mode":"orbit","fixedPoint":[-0.023845759791365943,0.5001]},"startArrowhead":null,"endArrowhead":"arrow","elbowed":false,"moveMidPointsWithElement":false},{"id":"w8G93gSYC8-x-p3PAByqX","type":"arrow","x":-1927.0740073851143,"y":273.416360698965,"width":38,"height":0.16210464917276113,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4U","roundness":{"type":2},"seed":360358204,"version":18,"versionNonce":749773188,"isDeleted":false,"boundElements":[],"updated":1776768062021,"link":null,"locked":false,"points":[[0,0],[18.999874999999975,-0.006839955000032205],[38,0.15526469417272892]],"startBinding":{"elementId":"cE_NunvyqKyhz7PVgjZYB","mode":"orbit","fixedPoint":[0.9999992548782191,0.5001]},"endBinding":{"elementId":"nfeJM6T69uI2f4cob5-9o","mode":"orbit","fixedPoint":[-0.02130470602920997,0.5001]},"startArrowhead":null,"endArrowhead":"arrow","elbowed":false,"moveMidPointsWithElement":false},{"id":"GzjgOVrvVdx2Je7GK5PH8","type":"arrow","x":-1689.3161948851139,"y":273.5456882013522,"width":37.99999999999977,"height":0.15248053577204246,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4V","roundness":{"type":2},"seed":1015749052,"version":21,"versionNonce":212455684,"isDeleted":false,"boundElements":[],"updated":1776768062021,"link":null,"locked":false,"points":[[0,0],[19.000062500000013,-0.13616745738727332],[37.99999999999977,0.016313078384769142]],"startBinding":{"elementId":"nfeJM6T69uI2f4cob5-9o","mode":"orbit","fixedPoint":[1.0000003328756295,0.5001]},"endBinding":{"elementId":"-LgUSNJNzU_xj31-hK5sC","mode":"orbit","fixedPoint":[-0.02499960937499992,0.5001]},"startArrowhead":null,"endArrowhead":"arrow","elbowed":false,"moveMidPointsWithElement":false},{"id":"-sEXe4xIC8EoiXZYYLPEU","type":"arrow","x":-1479.3161948851139,"y":273.5376052366718,"width":38.00000000000023,"height":0.3729116610854817,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"b4W","roundness":{"type":2},"seed":200835644,"version":20,"versionNonce":80810116,"isDeleted":false,"boundElements":[],"updated":1776768062021,"link":null,"locked":false,"points":[[0,0],[19.000062500000013,-0.12808449270676192],[38.00000000000023,0.24482716837871976]],"startBinding":{"elementId":"-LgUSNJNzU_xj31-hK5sC","mode":"orbit","fixedPoint":[1.0000003906250001,0.5001]},"endBinding":{"elementId":"KOdVI5yooWwi0AnYvairG","mode":"orbit","fixedPoint":[-0.052832586178890986,0.5093777777777777]},"startArrowhead":null,"endArrowhead":"arrow","elbowed":false,"moveMidPointsWithElement":false}],"files":{}}

Zsh has more files, but each file has a separate responsibility. The key difference lies in trigger conditions—different scenarios (scripts / login / interactive) take different paths:

{"type":"excalidraw/clipboard","elements":[{"id":"Vfq