{"id":515,"date":"2026-05-17T07:04:32","date_gmt":"2026-05-16T23:04:32","guid":{"rendered":"https:\/\/junai.ai\/blog\/ts-build-perf-19\/"},"modified":"2026-05-17T07:04:32","modified_gmt":"2026-05-16T23:04:32","slug":"ts-build-perf-19","status":"publish","type":"post","link":"https:\/\/junai.ai\/blog\/ts-build-perf-19\/","title":{"rendered":"\ube4c\ub4dc \uc131\ub2a5 \u2014 incremental\u00b7prj refs (\uace0\uae09 19\ud3b8)"},"content":{"rendered":"\n<!-- WordPress REST API \ubc1c\ud589\uc6a9 HTML (\uc790\ub3d9 \uc0dd\uc131) -->\n<!-- WP-FEATURED-MEDIA-ID: 314 -->\n<div style=\"max-width:800px;margin:0 auto;\">\n<style>\n:root{--color-primary:#3178c6;--color-accent:#60a5fa;--color-bg:#fafafa;--color-bg-card:#ffffff;--color-text:#1e293b;--color-text-muted:#64748b;--hero-start:#0f172a;--hero-end:#3178c6;--font-body:-apple-system,BlinkMacSystemFont,'Apple SD Gothic Neo','Noto Sans KR',sans-serif;--size-body:17px;--line-height:1.75;}\n*{box-sizing:border-box;}\n.container{max-width:760px;margin:0 auto;padding:0 22px 80px;}\n.hero{background:linear-gradient(135deg,var(--hero-start) 0%,var(--hero-end) 100%);color:#fff;padding:72px 22px 56px;text-align:center;}\n.hero .badge{display:inline-block;background:rgba(96,165,250,0.18);color:var(--color-accent);padding:6px 14px;border-radius:999px;font-size:13px;font-weight:600;letter-spacing:0.5px;margin-bottom:18px;}\n.hero h1{margin:0 0 18px;font-size:36px;line-height:1.3;letter-spacing:-0.3px;}\n.hero p.sub{margin:0 auto;max-width:580px;font-size:17px;color:#dbeafe;}\n.hero img{width:100%;max-width:720px;height:auto;margin:36px auto 0;display:block;border-radius:10px;box-shadow:0 8px 32px rgba(0,0,0,0.3);}\n.meta{display:flex;gap:14px;justify-content:center;margin-top:20px;font-size:13px;color:#93c5fd;flex-wrap:wrap;}\n.meta span::before{content:\"\u00b7\";margin-right:14px;color:#1e3a8a;}\n.meta span:first-child::before{content:\"\";margin:0;}\narticle{background:var(--color-bg-card);margin-top:-36px;padding:44px 28px;border-radius:14px;box-shadow:0 2px 18px rgba(0,0,0,0.06);}\narticle p{margin:0 0 18px;}\nh2{font-size:28px;line-height:1.35;letter-spacing:-0.3px;margin:48px 0 18px;padding-bottom:10px;border-bottom:2px solid var(--color-primary);}\nh2:first-of-type{margin-top:8px;}\nh3{font-size:21px;line-height:1.4;margin:30px 0 12px;color:var(--color-primary);}\ncode{background:#f1f5f9;color:#0f172a;padding:2px 6px;border-radius:4px;font-family:'SFMono-Regular',Menlo,Consolas,monospace;font-size:0.92em;}\npre{background:#0f172a;color:#e2e8f0;padding:18px 20px;border-radius:10px;overflow-x:auto;font-size:14.5px;line-height:1.65;margin:18px 0;}\npre code{background:transparent;color:inherit;padding:0;}\nul,ol{margin:0 0 18px;padding-left:24px;}\nli{margin-bottom:8px;}\nstrong{color:#0f172a;}\n.databox{background:#eff6ff;border-left:4px solid var(--color-primary);padding:18px 20px;border-radius:6px;margin:22px 0;}\n.databox p{margin:0 0 8px;}\n.databox p:last-child{margin:0;}\n.databox strong{color:var(--color-primary);}\n.warnbox{background:linear-gradient(135deg,#fef3c7 0%,#fde68a 100%);border-left:4px solid #d97706;padding:18px 20px;border-radius:6px;margin:22px 0;}\n.warnbox strong{color:#92400e;}\n.tablewrap{overflow-x:auto;-webkit-overflow-scrolling:touch;margin:22px 0;}\ntable{width:100%;border-collapse:collapse;font-size:15px;background:var(--color-bg-card);}\nth,td{padding:11px 12px;text-align:left;border-bottom:1px solid #e2e8f0;vertical-align:top;}\nth{background:#f1f5f9;font-weight:700;color:#0f172a;}\ntd:first-child,th:first-child{font-weight:700;}\n.cta{background:linear-gradient(135deg,#3178c6 0%,#60a5fa 100%);color:#fff;padding:30px 24px;border-radius:12px;margin-top:44px;text-align:center;}\n.cta h3{color:#fff;margin:0 0 10px;}\n.cta p{margin:0;color:#dbeafe;}\n.series-nav{background:#eff6ff;padding:18px 22px;border-radius:10px;margin-top:24px;font-size:14.5px;color:var(--color-text-muted);}\n.series-nav strong{color:var(--color-primary);}\n@media (max-width:480px){.hero{padding:52px 18px 44px;}.hero h1{font-size:26px;}.hero p.sub{font-size:15px;}article{padding:28px 18px;border-radius:10px;}h2{font-size:22px;}h3{font-size:18px;}body{font-size:16px;}pre{font-size:13px;padding:14px 16px;}}\n@media (max-width:560px){.tablewrap table,.tablewrap thead,.tablewrap tbody,.tablewrap tr,.tablewrap th,.tablewrap td{display:block;width:auto;}.tablewrap thead{display:none;}.tablewrap tr{margin:0 0 14px;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden;}.tablewrap td{border:none;border-bottom:1px solid #f1f5f9;padding:9px 14px;}.tablewrap td:first-child{background:#eff6ff;font-weight:800;font-size:15.5px;}.tablewrap td:last-child{border-bottom:none;}.tablewrap td[data-label]::before{content:attr(data-label) \" \u2014 \";font-weight:700;color:var(--color-primary);}}\n<\/style>\n<header class=\"hero\">\n  <span class=\"badge\">\ud0c0\uc785\uc2a4\ud06c\ub9bd\ud2b8 \uad50\uc7ac \u00b7 19\ud3b8 \/ 20\ud3b8<\/span>\n  <h1>\ube4c\ub4dc \uc131\ub2a5 \u2014 incremental\u00b7project references<\/h1>\n  <p class=\"sub\">10\ucd08 \ube4c\ub4dc\ub97c 1\ucd08\ub85c. \uce90\uc2f1\u00b7\ubd84\ud560\u00b7\ub300\uccb4 \ub3c4\uad6c.<\/p>\n  <div class=\"meta\"><span>\uace0\uae09<\/span><span>\uc77d\ub294 \uc2dc\uac04 7\ubd84<\/span><span>2026-05-17<\/span><\/div>\n  <img decoding=\"async\" src=\"https:\/\/junai.ai\/blog\/wp-content\/uploads\/2026\/05\/hero-89.jpg\" alt=\"\ud070 TS \ud504\ub85c\uc81d\ud2b8\uac00 \uce90\uc2f1\uacfc \ubd84\ud560\ub85c \ube4c\ub4dc \uc2dc\uac04\uc774 \uc904\uc5b4\ub4dc\ub294 \ub3c4\uc2dd\">\n<\/header>\n\n<div class=\"container\">\n<article>\n\n<p>TS \ube4c\ub4dc\ub294 \ud504\ub85c\uc81d\ud2b8\uac00 \ucee4\uc9c8\uc218\ub85d \ub290\ub824\uc9d1\ub2c8\ub2e4 \u2014 100\uac1c \ud30c\uc77c\uc774\uba74 \ubaa8\ub974\uaca0\uc9c0\ub9cc 10,000\uac1c\uba74 \ubcc0\uacbd \ud55c \ubc88\uc5d0 30\ucd08\uc529 \uac78\ub824\uc694. 19\ud3b8\uc740 \ube4c\ub4dc \uc2dc\uac04\uc744 \uc904\uc774\ub294 4\uac00\uc9c0 \ub3c4\uad6c \u2014 <strong>incremental<\/strong>, <strong>composite + project references<\/strong>, <strong>tsc &#8211;build<\/strong>, \uadf8\ub9ac\uace0 <strong>esbuild\/swc<\/strong> \uac19\uc740 \ub300\uccb4 \ub3c4\uad6c.<\/p>\n\n<h2>\u2460 incremental \u2014 \uce90\uc2dc\ub85c \uc7ac\ucef4\ud30c\uc77c \uc904\uc774\uae30<\/h2>\n\n<pre><code>{\n  \"compilerOptions\": {\n    \"incremental\": true,\n    \"tsBuildInfoFile\": \".tsbuildinfo\"   \/\/ \uce90\uc2dc \ud30c\uc77c \uc704\uce58\n  }\n}<\/code><\/pre>\n\n<p>tsc \uac00 \ub9c8\uc9c0\ub9c9 \ube4c\ub4dc \uc815\ubcf4\ub97c <code>.tsbuildinfo<\/code> \uc5d0 \uc800\uc7a5. \ub2e4\uc74c \ube4c\ub4dc\ub294 \ubcc0\uacbd\ub41c \ud30c\uc77c\ub9cc \uc7ac\ucef4\ud30c\uc77c. <strong>\uac70\uc758 \ud56d\uc0c1 \ucf1c\uc57c \ud558\ub294 \uc635\uc158<\/strong>.<\/p>\n\n<h2>\u2461 composite \u2014 \ub2e4\ub978 \ud504\ub85c\uc81d\ud2b8\uac00 \ucc38\uc870\ud560 \uc218 \uc788\uac8c<\/h2>\n\n<pre><code>\/\/ packages\/core\/tsconfig.json\n{\n  \"compilerOptions\": {\n    \"composite\": true,        \/\/ \ub2e4\ub978 \uacf3\uc5d0\uc11c \ucc38\uc870 \uac00\ub2a5\n    \"declaration\": true,      \/\/ .d.ts \uc0dd\uc131\n    \"outDir\": \".\/dist\",\n    \"rootDir\": \".\/src\"\n  },\n  \"include\": [\"src\"]\n}<\/code><\/pre>\n\n<h2>\u2462 project references \u2014 \ubaa8\ub178\ub808\ud3ec<\/h2>\n\n<pre><code>\/\/ \ub8e8\ud2b8 tsconfig.json\n{\n  \"files\": [],\n  \"references\": [\n    { \"path\": \".\/packages\/core\" },\n    { \"path\": \".\/packages\/web\" },\n    { \"path\": \".\/packages\/api\" }\n  ]\n}\n\n\/\/ packages\/web\/tsconfig.json (core \uc758\uc874)\n{\n  \"compilerOptions\": { ... },\n  \"references\": [\n    { \"path\": \"..\/core\" }\n  ]\n}<\/code><\/pre>\n\n<pre><code># \uc804\uccb4 \ube4c\ub4dc \u2014 \ubcc0\uacbd\ub41c \ud504\ub85c\uc81d\ud2b8\ub9cc \uc7ac\ube4c\ub4dc\ntsc --build\n\n# \uc815\ub9ac\ntsc --build --clean\n\n# \uac15\uc81c \uc804\uccb4\ntsc --build --force\n\n# watch \ubaa8\ub4dc\ntsc --build --watch<\/code><\/pre>\n\n<div class=\"databox\">\n  <p><strong>project references \uc758 \uc9c4\uac00.<\/strong> \ubaa8\ub178\ub808\ud3ec\uc5d0\uc11c <code>core<\/code> \ud328\ud0a4\uc9c0\ub9cc \ubc14\ub00c\uc5c8\uc73c\uba74 <code>core + \uadf8 \uc758\uc874<\/code> \ub9cc \uc7ac\ucef4\ud30c\uc77c. <code>core<\/code> \uac00 \uc548 \ubc14\ub00c\uc5c8\uc73c\uba74 <code>web<\/code> \uc740 \uce90\uc2dc\ub41c <code>.d.ts<\/code> \ub9cc \ubd04 \u2014 \ub9e4\uc6b0 \ube60\ub984. <strong>10\ubc30 \uc774\uc0c1 \ub2e8\ucd95<\/strong>.<\/p>\n<\/div>\n\n<h2>\u2463 esbuild\u00b7swc \u2014 TS \ucef4\ud30c\uc77c\ub7ec\ub97c \uc6b0\ud68c<\/h2>\n\n<pre><code># tsc \uac00 \ub290\ub9b0 \uc774\uc720 \u2014 TS \uac00 \ud480 \ud0c0\uc785 \uccb4\ud06c\ub97c \ud568\n# esbuild \uc640 swc \ub294 \ud0c0\uc785 \uccb4\ud06c \uc548 \ud558\uace0 \ubcc0\ud658\ub9cc (\uc218\uc2ed \ubc30 \ube60\ub984)\n\nnpm install -D esbuild\nnpx esbuild app.ts --bundle --outfile=dist.js\n# 1\ub9cc \uc904 0.05\ucd08\n\n# swc (vite, next.js \ub4f1\uc774 \ub0b4\uc7a5)\nnpm install -D @swc\/core\nnpx swc src -d dist<\/code><\/pre>\n\n<div class=\"warnbox\">\n  <p><strong>\uc911\uc694 \ud2b8\ub808\uc774\ub4dc\uc624\ud504.<\/strong> esbuild\u00b7swc \ub294 <strong>\ud0c0\uc785 \uccb4\ud06c\ub97c \uc548 \ud569\ub2c8\ub2e4<\/strong>. \ubcc0\ud658\ub9cc \ube60\ub974\uac8c. \ud0c0\uc785 \uc548\uc804\uc740 \ubcc4\ub3c4\ub85c <code>tsc --noEmit<\/code> \uc73c\ub85c \ud655\uc778\ud574\uc57c \ud568. \ubcf4\ud1b5\uc758 \ud328\ud134: <strong>esbuild \ub85c \ube60\ub974\uac8c \ubcc0\ud658 + tsc &#8211;noEmit \uc73c\ub85c \ud0c0\uc785 \uac80\uc0ac<\/strong>\ub97c CI \uc5d0\uc11c \ubcd1\ub82c \uc2e4\ud589.<\/p>\n<\/div>\n\n<h2>\uc2e4\uc804 \u2014 package.json \uc2a4\ud06c\ub9bd\ud2b8<\/h2>\n\n<pre><code>{\n  \"scripts\": {\n    \"dev\": \"vite\",                              \/\/ dev (esbuild \uae30\ubc18)\n    \"build\": \"vite build\",                       \/\/ prod (rollup + esbuild)\n    \"typecheck\": \"tsc --noEmit\",                 \/\/ \ud0c0\uc785\ub9cc \uac80\uc0ac\n    \"build:full\": \"npm run typecheck &amp;&amp; npm run build\"\n  }\n}<\/code><\/pre>\n\n<h2>\ud070 \ucf54\ub4dc\ubca0\uc774\uc2a4 \u2014 \uc810\uc9c4 \ucd5c\uc801\ud654 \uac00\uc774\ub4dc<\/h2>\n\n<div class=\"tablewrap\">\n<table>\n  <thead>\n    <tr><th>\uc99d\uc0c1<\/th><th>\ud574\uacb0<\/th><\/tr>\n  <\/thead>\n  <tbody>\n    <tr><td data-label=\"\">\uc804\uccb4 \ube4c\ub4dc 30\ucd08<\/td><td data-label=\"\">incremental: true<\/td><\/tr>\n    <tr><td data-label=\"\">\ubcc0\uacbd 1\uac1c\uc5d0\ub3c4 10\ucd08<\/td><td data-label=\"\">project references \ub85c \ubd84\ub9ac<\/td><\/tr>\n    <tr><td data-label=\"\">node_modules \ub85c\ub529 \ub290\ub9bc<\/td><td data-label=\"\">skipLibCheck: true<\/td><\/tr>\n    <tr><td data-label=\"\">VS Code \uac00 \ub290\ub9bc<\/td><td data-label=\"\">project references + \uc791\uc740 \ub2e8\uc704\ub85c \ubd84\ub9ac<\/td><\/tr>\n    <tr><td data-label=\"\">CI \uac00 \ub290\ub9bc<\/td><td data-label=\"\">esbuild \ubcc0\ud658 + \ubcc4\ub3c4 tsc \ud0c0\uc785 \uccb4\ud06c \ubcd1\ub82c<\/td><\/tr>\n    <tr><td data-label=\"\">test \uac00 \ub290\ub9bc<\/td><td data-label=\"\">vitest (esbuild \uae30\ubc18) \ub610\ub294 swc-jest<\/td><\/tr>\n  <\/tbody>\n<\/table>\n<\/div>\n\n<h2>tsconfig \ube4c\ub4dc \uc635\uc158 \ud55c \uc904 \uc815\ub9ac<\/h2>\n\n<pre><code>{\n  \"compilerOptions\": {\n    \"incremental\": true,           \/\/ \uce90\uc2dc (\uac70\uc758 \ud56d\uc0c1)\n    \"skipLibCheck\": true,          \/\/ node_modules .d.ts \uac74\ub108\ub700\n    \"isolatedModules\": true,       \/\/ \ud30c\uc77c\ubcc4 \ubcc0\ud658 \ub3c4\uad6c \ud638\ud658\n    \"composite\": true,             \/\/ \ub2e4\ub978 \ud504\ub85c\uc81d\ud2b8\uac00 \ucc38\uc870 \uac00\ub2a5 (\ud544\uc694\uc2dc)\n    \"declaration\": true,           \/\/ .d.ts \uc0dd\uc131 (composite \uba74 \ud544\uc218)\n    \"declarationMap\": true,        \/\/ \ub514\ubc84\uae45 \u2014 Go to definition\n    \"sourceMap\": true              \/\/ \ub7f0\ud0c0\uc784 \ub514\ubc84\uae45\uc6a9\n  }\n}<\/code><\/pre>\n\n<h2>\uce21\uc815 \u2014 \uc5b4\ub514\uac00 \ub290\ub9b0\uc9c0<\/h2>\n\n<pre><code># \uc9c4\ub2e8 \ubaa8\ub4dc\ntsc --extendedDiagnostics\n# Output:\n# Files:                         123\n# Lines of Library:           42385\n# Lines of Definitions:        9824\n# Nodes of Library:           93892\n# Types:                       1234\n# Memory used:                182MB\n# Total time:                  3.21s\n#   Parse time:               0.45s\n#   Bind time:                0.20s\n#   Check time:               2.10s  \u2190 \ud0c0\uc785 \uccb4\ud06c\uac00 \ub300\ubd80\ubd84\n#   Emit time:                0.41s\n\n# \ucd94\uc801\ntsc --generateTrace .\/trace\n# Chrome DevTools \uc758 Performance \ud0ed\uc5d0 trace.json \ub4dc\ub798\uadf8<\/code><\/pre>\n\n<div class=\"databox\">\n  <p><strong>\ud575\uc2ec \uacb0\ub860.<\/strong> Check time(\ud0c0\uc785 \uccb4\ud06c) \uac00 \ub300\ubd80\ubd84 \u2192 esbuild \ub85c \ubcc0\ud658\ub9cc \ube60\ub974\uac8c, tsc \ub294 typecheck \ub9cc. \ubd84\ub9ac\ud558\uba74 dev \uac00 \uac00\ubccd\uace0, CI \uc5d0\uc11c\ub9cc \ud480 typecheck.<\/p>\n<\/div>\n\n<div class=\"cta\">\n  <h3>20\ud3b8 \u2014 \uc2e4\uc804 \ud328\ud134 (Result\u00b7Branded\u00b7exhaustive) [\ucd5c\uc885\ud3b8]<\/h3>\n  <p>20\ud3b8 \uc2dc\ub9ac\uc988\uc758 \ub9c8\uc9c0\ub9c9. \uc9c4\uc9dc \ucf54\ub4dc\uc5d0\uc11c \uc790\uc8fc \uc4f0\ub294 \ud328\ud134 \ubaa8\uc74c.<\/p>\n<\/div>\n\n<div class=\"series-nav\">\n  <strong>\ud83d\udcda \uc27d\uac8c \ubc30\uc6b0\ub294 \ud0c0\uc785\uc2a4\ud06c\ub9bd\ud2b8 \uad50\uc7ac<\/strong><br>\n  \uc774\uc804: 18\ud3b8 strict \u00b7 \ud604\uc7ac: <strong>19\ud3b8 (\uace0\uae09)<\/strong> \u00b7 \ub2e4\uc74c \u2192 20\ud3b8 \uc2e4\uc804 \ud328\ud134 (\uc2dc\ub9ac\uc988 \ub9c8\uc9c0\ub9c9) \u00b7 \uc9c4\ud589: <strong>19\/20<\/strong>\n<\/div>\n\n<\/article>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>incremental\u00b7composite\u00b7project refs\u00b7esbuild\/swc \ub85c \ube4c\ub4dc \uc2dc\uac04 \uc904\uc774\uae30. 20\ud3b8 \uad50\uc7ac 19\ud3b8.<\/p>\n","protected":false},"author":1,"featured_media":314,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[18],"tags":[],"class_list":["post-515","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-typescript-basic"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/515","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/comments?post=515"}],"version-history":[{"count":0,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/515\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media\/314"}],"wp:attachment":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media?parent=515"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/categories?post=515"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/tags?post=515"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}