1.1 準(zhǔn)備環(huán)境：檢查Java版本與SSH配置

打開終端輸入java -version時，看到輸出顯示Java 8或Java 11才算符合Hadoop的運行要求。如果系統(tǒng)提示未安裝Java，可以通過官網(wǎng)下載AdoptOpenJDK，選擇LTS版本進行安裝。安裝完成后記得重啟終端讓配置生效。

接著在終端輸入ssh localhost測試SSH連接，首次連接可能需要輸入密碼。要實現(xiàn)無密碼登錄，運行ssh-keygen -t rsa生成密鑰對，把公鑰追加到授權(quán)文件：cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys。此時再執(zhí)行ssh localhost應(yīng)該能直接建立連接，避免后續(xù)Hadoop啟動時出現(xiàn)權(quán)限障礙。

1.2 下載并解壓Hadoop安裝包

訪問Apache Hadoop官網(wǎng)找到穩(wěn)定版二進制包（比如3.3.6版本），使用wget命令直接下載到指定目錄。解壓時推薦用tar -xzvf hadoop-3.3.6.tar.gz命令釋放文件，將解壓后的文件夾移動到/usr/local/hadoop路徑。如果遇到權(quán)限拒絕，可嘗試sudo chown -R $USER /usr/local/hadoop修改目錄歸屬，確保當(dāng)前用戶能自由操作文件。

1.3 配置環(huán)境變量（HADOOP_HOME與PATH）

在用戶根目錄的.bash_profile或.zshrc文件里添加兩行關(guān)鍵配置：export HADOOP_HOME=/usr/local/hadoop和export PATH=$PATH:$HADOOP_HOME/bin:$HADOOP_HOME/sbin。使用zsh的用戶要特別注意，Mac系統(tǒng)默認(rèn)shell從Catalina版本開始切換為zsh，修改完成后必須執(zhí)行source ~/.zshrc激活配置，否則運行hadoop命令時會提示"command not found"。

1.4 驗證安裝：運行hadoop version命令

在終端直接輸入hadoop version，如果屏幕上顯示類似"Hadoop 3.3.6"的版本信息，說明核心組件已正確安裝。遇到報錯可以檢查HADOOP_HOME路徑是否包含bin目錄，或者用echo $PATH查看環(huán)境變量是否包含Hadoop的執(zhí)行路徑。有時候需要完全關(guān)閉終端重新打開，讓系統(tǒng)徹底刷新環(huán)境變量配置。

2.1 配置Hadoop單節(jié)點模式：編輯core-site.xml與hdfs-site.xml

進入$HADOOP_HOME/etc/hadoop目錄，用文本編輯器打開core-site.xml。在configuration標(biāo)簽內(nèi)添加<property>塊，指定文件系統(tǒng)入口：<name>fs.defaultFS</name>配合<value>hdfs://localhost:9000</value>。這個配置決定了HDFS的訪問地址，端口號9000是默認(rèn)通信端口，如果被其他程序占用需要修改。

繼續(xù)編輯hdfs-site.xml文件，設(shè)置HDFS存儲路徑和副本數(shù)。添加<property>節(jié)點定義數(shù)據(jù)存儲目錄：<name>dfs.datanode.data.dir</name>對應(yīng)的<value>/usr/local/hadoop/hdfs/data</value>，同時設(shè)置dfs.replication為1（單節(jié)點模式）。記得提前創(chuàng)建對應(yīng)目錄并執(zhí)行chmod 755授權(quán)，否則啟動時可能出現(xiàn)"Permission denied"錯誤。

2.2 首次啟動Hadoop時的權(quán)限與端口沖突處理

執(zhí)行start-dfs.sh啟動腳本時，如果遇到"Could not create directory"報錯，大概率是存儲目錄權(quán)限不足。嘗試用sudo chown -R $USER:$USER /usr/local/hadoop遞歸修改目錄所有權(quán)。當(dāng)控制臺提示端口已被占用（如8088或9000），運行lsof -i :9000查找占用進程，關(guān)閉相關(guān)服務(wù)或修改Hadoop配置文件中對應(yīng)的端口號。

部分用戶在初始化namenode時會出現(xiàn)格式化失敗，這時候需要先執(zhí)行hdfs namenode -format強制初始化。格式化成功后刪除hdfs目錄下的所有臨時文件，重新啟動集群。如果瀏覽器訪問http://localhost:9870時頁面無法加載，檢查防火墻設(shè)置是否阻止了Hadoop服務(wù)的端口通信。

2.3 排查日志錯誤：NameNode未啟動或DataNode連接失敗

查看日志是最直接的排錯方式，NameNode日志位于$HADOOP_HOME/logs/hadoop-*-namenode-*.log。當(dāng)發(fā)現(xiàn)"Address already in use"錯誤，可能是端口沖突或之前的Hadoop進程未完全退出。執(zhí)行jps命令查看Java進程，手動用kill -9終止殘留的NameNode或DataNode進程。

DataNode無法連接NameNode時，首先檢查core-site.xml中配置的IP和端口是否一致。在DataNode的日志中看到"Connection refused"提示，嘗試在NameNode節(jié)點執(zhí)行netstat -an | grep 9000確認(rèn)端口監(jiān)聽狀態(tài)。有時候需要重新格式化NameNode并清空所有DataNode的存儲目錄，保持集群元數(shù)據(jù)一致性。

2.4 環(huán)境變量失效的修復(fù)方法（zsh/bash配置沖突）

輸入hadoop命令突然失效，很可能是shell環(huán)境配置混亂。打開終端執(zhí)行echo $SHELL確認(rèn)當(dāng)前使用的shell類型。zsh用戶需要檢查~/.zshrc文件末尾是否有source ~/.bash_profile語句，或者在.zshrc中直接寫入HADOOP_HOME和PATH的配置項。

當(dāng)同時存在.bash_profile和.zshrc時，建議統(tǒng)一環(huán)境變量配置位置。執(zhí)行nano ~/.zshrc后添加export PATH="$HADOOP_HOME/bin:$PATH"，保存后運行exec zsh重新加載配置。如果PATH變量顯示異常，可以用tr ':' '\n' <<< "$PATH"命令逐行查看路徑順序，確保Hadoop的bin目錄出現(xiàn)在系統(tǒng)默認(rèn)路徑之前。