【Node.js実戦習得】第5回：package.jsonを解き明かす ＆ モジュールシステムの歴史とモダン化への道

1. package.jsonの役割を解剖！プロジェクトの初期化

cd ~/nodejs-sample
mkdir node-npm-demo
cd node-npm-demo

# プロジェクトの初期化（すべてデフォルト設定で強制生成）
npm init -y

{
  "name": "node-npm-demo",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "description": ""
}

💡 実務視点での各項目ディープ解説

• name / version： プロジェクトの識別名とバージョンよ。もし自作のライブラリとして世界（npmレジストリ）に公開するなら全世界でユニークにする必要があるけれど、社内のWebサーバーやAPIを構築するだけなら初期値のままで問題ない。ただし、バージョン表記は セマンティックバージョニング（メジャー.マイナー.パッチ） の規則に従うのがマナーね。
• main： このプロジェクトの「エントリポイント」を指定する場所。他のプログラムからこのフォルダ自体が呼び出されたときに、最初に実行されるファイルを指定するの。デフォルトは index.js になっているわね。
• scripts： ショートカットコマンドを登録する場所。複雑なバックエンドの起動コマンドや、テスト、リント（静的解析）を一元管理する、開発効率の要よ。

2. 外部ライブラリの導入と node_modules に課された「3つの鉄則」

npm install date-fns

  "dependencies": {
    "date-fns": "^4.4.0"
  }

🚨 node_modules を Git に入れてはいけない3つの理由

1. ファイル数と容量が「異常」に肥大化する： node_modules の中は、あなたが直接入れたライブラリだけでなく、そのライブラリが依存している別のライブラリ……と芋づる式に何千・何万というファイルがダウンロードされるよ。これをGit管理に含めると、リポジトリの容量が大きくなりすぎて、クローンやプッシュの動作がめちゃくちゃ重くなるわ。
2. 「環境依存」のバイナリが含まれるケースがある： ライブラリの中には、インストールしたその瞬間に、そのマシンのOS（Windows、Mac、Linux）やCPUアーキテクチャに合わせて、内部のC言語などのソースコードをコンパイルして動的実体を作るものがあるの。つまり、Windows環境で生成した node_modules をそのままGit経由でLinuxのサーバーに持っていっても、互換性がなくて絶対に動かないよ。
3. そもそも共有する必要がない： これが最大の理由ね。

node_modules/

 

3. npm scripts を使いこなす！サーバー起動コマンドの共通化

touch index.js

// index.js
const { format } = require('date-fns');

const now = new Date();
const formattedDate = format(now, 'yyyy年MM月dd日 HH時mm分ss秒');

console.log('現在時刻:', formattedDate);

  "scripts": {
    "start": "node index.js"
  },

npm start

4. 2つのモジュールシステム：CommonJS（CJS）と ES Modules（ESM）の深い溝

• CommonJS（CJS）： require() と module.exports を使う。Node.jsが誕生した初期から使われている、サーバーサイドJavaScriptの伝統的規格。
• ES Modules（ESM）： import と export を使う。JavaScriptの言語公式規格（ECMAScript）が、後から正式に定めたブラウザ共通の標準方式。

5. 【実戦】Node.js環境でモダンな「import / export」を解禁する方法

方法①：package.json に "type": "module" を指定する（現代のデファクトスタンダード）

{
  "name": "node-npm-demo",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module", 
  "scripts": {
    "start": "node index.js"
  }
}

// index.js (ES Modules形式にアップデート)
import { format } from 'date-fns';

const now = new Date();
const formattedDate = format(now, 'yyyy年MM月dd日 HH時mm分ss秒');

console.log('現在時刻（ESM版で型安全に実行）:', formattedDate);

npm start

方法②：拡張子を .mjs にする（ピンポイント切り替え）

第5回 まとめ

• package.json： プロジェクトの心臓部（設計図）。外部ライブラリのバージョン管理や、複雑な起動コマンド（npm scripts）を集約する。
• node_modulesの鉄則： 実体は超巨大かつ環境依存のバイナリを含むため、絶対に Git の管理に含めてはならない。必ず .gitignore に登録し、開発者各自のローカル環境で npm install を叩いて再現する。
• 2つのモジュールシステム： 先駆者としての歴史を持つ require (CommonJS) と、後発ながらJavaScriptの公式標準となった import (ES Modules) が存在する。
• モダン化への設定： 現代のNode.js開発の現場で import 構文を標準利用する場合、package.json に "type": "module" を指定するのが実務のセオリー！

次回：第6回「Node.jsプロジェクトへのTypeScript導入とtsconfig.jsonの設定」に続く