https://www.nyanmo.info/tags/npx/ Recent content in Npx on Nyanmo main blog Hugo ja Tue, 18 Aug 2026 08:39:41 +0900 https://www.nyanmo.info/posts/webdevelop/nodejsandnpmwillendeduponcommandnotfoundwhentheprojectpathismalformedforbashpathsetting/ Tue, 18 Aug 2026 08:39:41 +0900 https://www.nyanmo.info/posts/webdevelop/nodejsandnpmwillendeduponcommandnotfoundwhentheprojectpathismalformedforbashpathsetting/ <h2 id="この記事を作った動機">この記事を作った動機</h2> <p>　Linux 環境にて簡単に Web アプリを作ろうとしたところ、以下のようになって開発サーバを立ち上げられない事態になり、開発が続行できなくなったということがあって、だいぶ時間を溶かしたので記録を取る。</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>npm create vite@latest </span></span><span style="display:flex;"><span><span style="color:#75715e"># ...</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># npx でも症状は同じ</span> </span></span><span style="display:flex;"><span>npm run dev </span></span><span style="display:flex;"><span><span style="color:#75715e"># npm notice run rss-listing@0.0.0 dev</span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># npm notice run vite</span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># sh: 行 1: vite: command not found</span> </span></span></code></pre></div><h2 id="簡単な結論">簡単な結論</h2> <p>　npm を使ったプロジェクトを立ち上げる際は、フォルダのパスに特殊文字が含まれていないか注意する。<code>:</code>がパスに含まれていた場合、npm はそれを自動的にエスケープするなどの処理をせずに、<code>PATH</code>を登録してしまう。npm の機構によって動的に<code>PATH</code>が正しく登録できないと、npm でインストールされたパッケージのバイナリやスクリプトが必要なタイミングで実行できず、開発を続行できない。BASH の PATH の解釈が不正なところで途切れて、npm の動作に必要なバイナリやスクリプトへのパスが通らず、動作が破綻する。問題の具体例は以下のとおりである。</p> <ul> <li>問題のパスの例</li> </ul> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#75715e"># /home/useName/work/free/2026-08-18-09:16:14-1787012174/ProjectName/node_modules/.bin</span> </span></span></code></pre></div><ul> <li>問題のパスが npm(npx) によって、PATH に登録される例</li> </ul> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#75715e"># /home/useName/work/free/2026-08-18-09:16:14-1787012174/ProjectName/node_modules/.bin:/home/linuxbrew/.linuxbrew/bin:/home/linuxbrew/.linuxbrew/sbin:/opt/miniconda3/condabin:/usr/local/bin # 実際にはもっと長く続くが例として途中でちょん切っている。</span> </span></span></code></pre></div><ul> <li>BASH での解釈のされ方の例</li> </ul> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#75715e"># /home/useName/work/free/2026-08-18-09 # 意図しないところでパスがちょん切れる</span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># 16 # 意図しないところでパスがちょん切れる</span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># 14-1787012174/ProjectName/node_modules/.bin </span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># /home/linuxbrew/.linuxbrew/bin</span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># /home/linuxbrew/.linuxbrew/sbin</span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># /opt/miniconda3/condabin</span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># /usr/local/bin</span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># ...</span> </span></span></code></pre></div><p>　なおこのような問題は、Windows など最初から、&quot;:&quot; の文字がフォルダ名などに特殊文字として登録できないファイルシステムを使う環境では起こらないかもしれない。私が、普段の環境で使っているのは、Ext4 というファイルシステムであり、&quot;:&ldquo;がファイル名やフォルダ名に含めることができ、問題が起こったものだと思われる。npm 関連のリポジトリにこれについて Issue を作ったり Pull Request を作るべきかは謎であるが、私はその点に関して自信は何もないので、結局何もしないだろう。</p>