導覽
print working directory
pwd
pwd意思
打印終端當前工作目錄的絕對路徑。
使用時機
在執行需要位於專案資料夾中的指令之前，先執行它。
範例
pwd請求範例
檢查終端機目前所在的資料夾。
程式設計
常用終端機指令
整理編輯、執行、測試與除錯 Web 專案時常用的終端機指令。
33 個指令
導覽
列出文件。
ls
ls意思
顯示目前目錄中的檔案和資料夾。
使用時機
用於確認是否存在預期的檔案，例如 package.json、src 或 next.config.mjs。
範例
ls請求範例
列出當前項目資料夾中的文件。
導覽
更改目錄
cd
cd ~/projects/my-web-app意思
將終端機移動到另一個資料夾。
使用時機
在運行專案特定的命令（例如 `npm run build`）之前，使用它。
注意
如果您處於錯誤的目錄中，命令可能會失敗，即使命令本身是正確的。
範例
cd ~/projects/my-web-app請求範例
在執行命令之前，移動到專案資料夾。
導覽
clear screen
clear
clear意思
清除可見的終端輸出，而不會更改檔案或命令歷史記錄。
使用時機
在重新運行命令時，如果舊輸出包含視覺噪點，使用它。
範例
clear請求範例
在重新執行構建之前，清除終端機。
檔案與資料夾
顯示檔案內容。
cat
cat package.json意思
打印文件的內容到終端。
使用時機
適用於小型檔案，例如 `package.json`、組態檔案或小型文字檔案。
注意
對於非常大的文件，請使用 `sed`、`rg` 或分頁器，而不是一次性顯示所有內容。
範例
cat package.json請求範例
顯示 package.json 中的腳本。
檔案與資料夾
顯示選定的行。
sed
sed -n '1,120p' src/components/SiteHeader.tsx意思
可以列印文件中的選定行範圍。
使用時機
用於檢查源檔案的一個部分，而無需打開整個檔案。
範例
sed -n '1,120p' src/components/SiteHeader.tsx請求範例
顯示 SiteHeader.tsx 的前 120 行。
檔案與資料夾
make directory
mkdir
mkdir -p src/app/[locale]/reference/terminal-commands意思
建立一個新的資料夾。 -p 選項也會建立遺漏的父資料夾，並在資料夾已存在時避免失敗。
使用時機
在添加新的頁面資料夾或資源資料夾之前，使用它。
範例
mkdir -p src/app/[locale]/reference/terminal-commands請求範例
建立終端命令頁面的路由資料夾。
檔案與資料夾
複製檔案
cp
cp .env.example .env.local意思
將檔案或資料夾複製到另一個位置。
使用時機
用於從範例檔案創建本地配置或複製範本。
注意
如果目標文件已存在，cp 可以覆蓋它。
範例
cp .env.example .env.local請求範例
僅在不會覆寫本機設定時，才複製範例環境檔案。
檔案與資料夾
移动或重命名。
mv
mv old-name.ts new-name.ts意思
移動檔案或資料夾，或在目的地位於相同資料夾時，重新命名它。
使用時機
在更改檔案名稱、資料夾名稱或移動資源時使用。
注意
重新命名路由資料夾會更改 URL。
範例
mv old-name.ts new-name.ts請求範例
重新命名此檔案，如果需要，請更新匯入。
安全操作
移除檔案。
rm
rm unused-file.ts意思
刪除檔案。 使用 `-r` 可以遞迴刪除資料夾。
使用時機
僅當檔案是故意從專案中移除時才使用。
注意
rm is destructive. Check the path carefully before running it.
範例
rm unused-file.ts請求範例
在刪除此檔案之前，請說明將會刪除什麼。
搜尋與檢查
ripgrep 搜尋。
rg
rg -n "errorMessageGuide" src意思
快速搜尋所有檔案中的文字。
使用時機
用於在編輯之前找到匯入、組件、slug、CSS 類別或舊名稱。
範例
rg -n "errorMessageGuide" src請求範例
搜尋此元件被導入的位置。
搜尋與檢查
快速列出已跟踪的文件。
rg --files
rg --files src/app意思
快速列出文件路徑，同時尊重常見的忽略規則。
使用時機
用於在不掃描構建輸出的情況下找到頁面檔案、組件和函式庫。
範例
rg --files src/app請求範例
在 src/app 下列出參考頁面文件。
搜尋與檢查
find paths
find
find src -name 'page.tsx'意思
依路徑、名稱或其他檔案屬性搜尋檔案系統。
使用時機
在按檔案名稱模式搜尋，而不是按文本內容時使用。
範例
find src -name 'page.tsx'請求範例
查找每個 page.tsx 路由檔案。
搜尋與檢查
統計行數或字數
wc
wc -l src/lib/terminal-commands.ts意思
統計行數、單字數或位元組數。
使用時機
用於估算檔案大小或在結合其他命令時計算搜尋結果。
範例
wc -l src/lib/terminal-commands.ts請求範例
計算此資料檔案中的行數。
套件
安裝依賴項
npm install
npm install意思
安裝 `package.json` 和 `package-lock.json` 文件中列出的包。
使用時機
在複製專案或缺少依賴項時，使用它。
注意
如果依賴項的版本解析方式不同，它可能會更改 `package-lock.json` 文件。
範例
npm install請求範例
僅在 `node_modules` 缺失時才安裝依賴項。
開發伺服器
啟動開發伺服器
npm run dev
npm run dev意思
執行專案的本機開發伺服器指令。
使用時機
運用它來在編輯時，在瀏覽器中測試頁面。
注意
正在運行的開發伺服器會使終端會話保持活躍，直到停止。
範例
npm run dev請求範例
啟動開發伺服器，並告訴我本地 URL。
套件
production build
npm run build
npm run build意思
執行生產環境建置指令，並發現許多編譯、路由和類型問題。
使用時機
在部署或新增頁面後，執行它。
範例
npm run build請求範例
執行生產環境建置，並總結警告或錯誤。
套件
代码检查。
npm run lint
npm run lint意思
執行專案的 lint 指令，以發現樣式和靜態程式碼問題。
使用時機
當您需要快速回饋時，在編譯之前執行它。
範例
npm run lint請求範例
執行 lint 工具，並僅顯示可採取行動的錯誤。
套件
檢查 Node 版本
node -v
node -v意思
打印已安裝的 Node.js 版本。
使用時機
運用它，當專案需要特定的 Node 版本時。
範例
node -v請求範例
在解釋此警告之前，檢查 Node.js 版本。
套件
執行套件命令。
npx
npx next info意思
執行來自已安裝或暫時下載的 npm 封裝的指令。
使用時機
適用於沒有套件腳本的一次性工具命令。
注意
npx can download packages from the network if they are not installed.
範例
npx next info請求範例
說明這個 npx 命令是否需要網絡訪問。
Git
檢查 Git 狀態
git status
git status --short意思
顯示當前分支以及已提交、已暫存或未追蹤的檔案。
使用時機
在編輯、提交、拉取或切換分支之前，執行它。
範例
git status --short請求範例
檢查 Git 狀態，並總結已變更的檔案。
Git
顯示程式碼差異。
git diff
git diff -- src/components/SiteHeader.tsx意思
顯示已更改檔案的逐行差異。
使用時機
運用它來查看提交之前，確切地了解哪些內容已更改。
範例
git diff -- src/components/SiteHeader.tsx請求範例
審查此任務的差異。
Git
檢視提交歷史記錄
git log
git log --oneline -5意思
顯示提交歷史記錄。
使用時機
運用它來查看最近的工作，或找到要檢查的提交。
範例
git log --oneline -5請求範例
顯示最近的五個提交。
Git
場景變化
git add
git add src/lib/terminal-commands.ts意思
選擇要包含在下一個提交中的變更。
使用時機
使用明確的路徑，用於專注的提交。
範例
git add src/lib/terminal-commands.ts請求範例
僅限於與此終端命令頁面相關的文件。
Git
儲存提交。
git commit
git commit -m "Add terminal command reference"意思
將階段性變更記錄到 Git 歷史記錄中。
使用時機
在審查已暫存的更改之後，使用它。
範例
git commit -m "Add terminal command reference"請求範例
使用清晰的訊息提交已暫存的變更。
開發伺服器
停止執行命令
Ctrl+C
在開發伺服器終端機中按下 Ctrl+C。意思
中斷當前正在執行的終端命令。
使用時機
運用它來停止本地開發伺服器，在關閉終端機或更改端口之前。
注意
在命令正在執行的終端機會話中使用。
範例
在開發伺服器終端機中按下 Ctrl+C。請求範例
停止正在運行的開發伺服器。
開發伺服器
列出打开的文件和端口。
lsof
lsof -i :3001意思
可以顯示哪個進程正在使用哪個端口。
使用時機
運用它，當開發伺服器以 EADDRINUSE 錯誤失敗時。
範例
lsof -i :3001請求範例
找到哪個進程正在使用 3001 埠。
開發伺服器
列出进程。
ps
ps aux意思
顯示正在運行的進程。
使用時機
用於檢查正在運行的開發工具、伺服器或後台進程。
範例
ps aux請求範例
檢查 Next.js 開發伺服器是否仍在運行。
安全操作
透過 PID 停止進程
kill
kill 12345意思
根據進程 ID 發送信號以停止進程。
使用時機
在伺服器在正常中斷無法處理的情況下持續運行時使用。
注意
仔細檢查 PID，以避免停止錯誤的進程。
範例
kill 12345請求範例
在終止任何進程之前，請告訴我 PID 所代表的進程。
網路
发送 HTTP 请求。
curl
curl -I http://localhost:3001/ko意思
從終端發送 HTTP 請求並印出回應。
使用時機
用於檢查本地或部署的 URL 是否返回 200、404、500 或重定向。
範例
curl -I http://localhost:3001/ko請求範例
使用 curl 檢查此頁面是否返回 200。
網路
檢查網路連線
ping
ping 172.30.1.55意思
檢查主機是否對基本的網路封包做出回應。
使用時機
將其用作網路可達性的粗略檢查，而不是作為 Web 應用程式的健康檢查。
範例
ping 172.30.1.55請求範例
檢查此設備是否可以連接到開發機的 IP 位址。
搜尋與檢查
查找可执行命令。
which
which node意思
顯示哪個可執行檔案將用於某個命令名稱。
使用時機
在機器上可能存在不同的 Node、npm 或工具版本時使用。
範例
which node請求範例
檢查正在使用的 Node 可執行檔。
安全操作
更改文件權限
chmod
chmod +x script.sh意思
變更檔案的讀取、寫入或執行權限。
使用時機
運用它，當需要讓本地腳本可執行時。
注意
避免進行廣泛的權限變更，例如 chmod -R 777。
範例
chmod +x script.sh請求範例
說明此腳本中最安全的權限變更。