<div id="readability-page-1" class="page"><div><div aria-hidden="false"><a rel="noopener follow" href="/?source=post_page---byline--f54698f618e8---------------------------------------"><div><p><img alt="이상문" src="https://miro.medium.com/v2/resize:fill:88:88/1*PdFTYwkEj-ebxhH52VWJ8w.png" width="44" height="44" loading="lazy" data-testid="authorPhoto"></p></div></a></div><p id="a3cb">이 글에서는 윈도우 환경에서 Node.js를 설치하고, <code>node -v</code> 및 <code>npm -v</code> 명령어가 정상적으로 작동하도록 설정하는 방법을 단계별로 정리한다.</p><h2 id="466d"><strong>1. fnm 설치</strong></h2><p id="4211">fnm은 Node.js 버전 관리자이다. 이를 통해 여러 Node.js 버전을 쉽게 설치하고 관리할 수 있다.</p><ul><li id="03b0"><strong>PowerShell을 실행한다.</strong></li><li id="9266"><strong>다음 명령을 실행하여 fnm을 설치합니다.</strong></li></ul><pre><span id="e9f4">winget install Schniz.fnm</span></pre><ul><li id="02d0">설치 과정에서 몇 가지 질문이 나올 수 있다. <code>y</code>를 입력하여 진행한다.</li></ul><h2 id="10f4"><strong>2. Node.js 설치</strong></h2><p id="a801">fnm을 사용하여 Node.js를 설치한다. 여기서는 Node.js 버전 22를 설치한다.</p><ul><li id="b1e2"><strong>PowerShell에서 다음 명령을 실행한다.</strong></li></ul><pre><span id="e8fd">fnm install 22</span></pre><ul><li id="cbff">fnm이 Node.js 22 버전을 다운로드하고 설치한다.</li><li id="8bf8"><strong>설치가 완료되면, 다음 명령을 실행하여 사용할 Node.js 버전을 설정한다.</strong></li></ul><pre><span id="2fcf">fnm use 22</span></pre><h2 id="f320"><strong>3. 환경 변수 설정 (PowerShell)</strong></h2><p id="0975">PowerShell에서 <code>node</code> 및 <code>npm</code> 명령어를 사용하려면 환경 변수를 설정해야 한다.</p><ul><li id="afd4"><strong>PowerShell을 실행한다.</strong></li><li id="0fae"><strong>PowerShell 프로필 파일을 생성한다. (아직 없는 경우).</strong></li></ul><pre><span id="542e">if (-not (Test-Path $profile)) { New-Item $profile -Force }</span></pre><ul><li id="dfe1">프로필 파일을 편집하기 위해서 다음을 실행한다.</li></ul><pre><span id="af3e">Invoke-Item $profile</span></pre><ul><li id="bbd6"><strong>연결할 프로그램을 선택하는 창이 나오는데, 텍스트 편집기를 선택하면 된다. 다음 fnm 초기화 스크립트를 PowerShell 프로필 파일에 추가한다.</strong></li></ul><pre><span id="116a">fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression</span></pre><ul><li id="1cd0"><strong>PowerShell 실행 정책을 변경한다.</strong></li></ul><pre><span id="a7bd">Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned</span></pre><ul><li id="b46e"><strong>PowerShell을 닫고 다시 실행한다.</strong> 변경 사항을 적용하려면 PowerShell을 다시 시작해야 한다.</li><li id="edbf"><strong>PowerShell에서 다음 명령을 실행하여 Node.js 및 npm 버전을 확인한다.</strong></li></ul><pre><span id="98d0">node -v <br>npm -v</span></pre><ul><li id="1200">“v22.14.0” 및 “10.9.2” (또는 유사한 버전)이 출력되어야 한다.</li></ul><h2 id="6649"><strong>4. Command Prompt 설정</strong></h2><p id="8ccd">Command Prompt (cmd.exe)에서도 <code>node</code> 및 <code>npm</code> 명령어를 사용하려면 추가 설정이 필요하다.</p><ul><li id="f118"><strong>Command Prompt를 실행한다.</strong> (관리자 권한은 필요하지 않다.)</li><li id="e943">다음 내용을 포함하는 fnm_init.cmd 파일을 C:\Users\&lt;YourUsername&gt;에 생성한다.</li></ul><pre><span id="4370">@echo off<br>:: for /F will launch a new instance of cmd so we create a guard to prevent an infnite loop<br>if not defined FNM_AUTORUN_GUARD (<br>    set "FNM_AUTORUN_GUARD=AutorunGuard"<br>    FOR /f "tokens=*" %%z IN ('fnm env --use-on-cd') DO CALL %%z<br>)</span></pre><ul><li id="9090"><strong>다음 명령을 실행하여 Windows 레지스트리에 fnm 초기화 스크립트를 자동 실행하도록 등록한다.</strong> <strong>주의:</strong> 이 명령은 레지스트리를 수정합니다. 오타 없이 정확하게 입력해야 합니다. <code>&lt;YourUsername&gt;</code>를 실제 사용자 이름으로 바꿔서 실행한다.</li></ul><pre><span id="9f18">REG ADD "HKCU\Software\Microsoft\Command Processor" /v AutoRun /t REG_SZ /d "CALL \"C:\Users\&lt;YourUsername&gt;\fnm_init.cmd\"" /f</span></pre><ul><li id="f6d3"><strong>Command Prompt를 닫고 다시 실행한다.</strong> 변경 사항을 적용하려면 Command Prompt를 다시 시작해야 한다.</li><li id="4401"><strong>Command Prompt에서 다음 명령을 실행하여 Node.js 및 npm 버전을 확인한다.</strong></li></ul><pre><span id="5502">node -v <br>npm -v</span></pre><ul><li id="20d6">“v22.14.0” 및 “10.9.2” (또는 유사한 버전)이 출력되어야 한다.</li></ul></div></div>

Stories by 이상문 on Medium

이 글에서는 윈도우 환경에서 Node.js를 설치하고, node -v 및 npm -v 명령어가 정상적으로 작동하도록 설정하는 방법을 단계별로 정리한다.
1. fnm 설치
fnm은 Node.js 버전 관리자이다. 이를 통해 여러 Node.js 버전을 쉽게 설치하고 관리할 수 있다.
PowerShell을 실행한다.
다음 명령을 실행하여 fnm을 설치합니다.
winget install Schniz.fnm
설치 과정에서 몇 가지 질문이 나올 수 있다. y를 입력하여 진행한다.
2. Node.js 설치
fnm을 사용하여 Node.js를 설치한다. 여기서는 Node.js 버전 22를 설치한다.
PowerShell에서 다음 명령을 실행한다.
fnm install 22
fnm이 Node.js 22 버전을 다운로드하고 설치한다.
설치가 완료되면, 다음 명령을 실행하여 사용할 Node.js 버전을 설정한다.
fnm use 22
3. 환경 변수 설정 (PowerShell)
PowerShell에서 node 및 npm 명령어를 사용하려면 환경 변수를 설정해야 한다.
PowerShell을 실행한다.
PowerShell 프로필 파일을 생성한다. (아직 없는 경우).
if (-not (Test-Path $profile)) { New-Item $profile -Force }
프로필 파일을 편집하기 위해서 다음을 실행한다.
Invoke-Item $profile
연결할 프로그램을 선택하는 창이 나오는데, 텍스트 편집기를 선택하면 된다. 다음 fnm 초기화 스크립트를 PowerShell 프로필 파일에 추가한다.
fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression
PowerShell 실행 정책을 변경한다.
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
PowerShell을 닫고 다시 실행한다. 변경 사항을 적용하려면 PowerShell을 다시 시작해야 한다.
PowerShell에서 다음 명령을 실행하여 Node.js 및 npm 버전을 확인한다.
node -v 
npm -v
“v22.14.0” 및 “10.9.2” (또는 유사한 버전)이 출력되어야 한다.
4. Command Prompt 설정
Command Prompt (cmd.exe)에서도 node 및 npm 명령어를 사용하려면 추가 설정이 필요하다.
Command Prompt를 실행한다. (관리자 권한은 필요하지 않다.)
다음 내용을 포함하는 fnm_init.cmd 파일을 C:\Users\<YourUsername>에 생성한다.
@echo off
:: for /F will launch a new instance of cmd so we create a guard to prevent an infnite loop
if not defined FNM_AUTORUN_GUARD (
    set "FNM_AUTORUN_GUARD=AutorunGuard"
    FOR /f "tokens=*" %%z IN ('fnm env --use-on-cd') DO CALL %%z
)
다음 명령을 실행하여 Windows 레지스트리에 fnm 초기화 스크립트를 자동 실행하도록 등록한다. 주의: 이 명령은 레지스트리를 수정합니다. 오타 없이 정확하게 입력해야 합니다. <YourUsername>를 실제 사용자 이름으로 바꿔서 실행한다.
REG ADD "HKCU\Software\Microsoft\Command Processor" /v AutoRun /t REG_SZ /d "CALL \"C:\Users\<YourUsername>\fnm_init.cmd\"" /f
Command Prompt를 닫고 다시 실행한다. 변경 사항을 적용하려면 Command Prompt를 다시 시작해야 한다.
Command Prompt에서 다음 명령을 실행하여 Node.js 및 npm 버전을 확인한다.
node -v 
npm -v
“v22.14.0” 및 “10.9.2” (또는 유사한 버전)이 출력되어야 한다.

윈도우에서 Node.js 설치 및 설정 매뉴얼

댓글