81 lines
1.6 KiB
Markdown
81 lines
1.6 KiB
Markdown
|
---
|
|||
|
|
description: 設定您偏好的套件管理器 (npm/pnpm/yarn/bun)
|
|||
|
|
disable-model-invocation: true
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 套件管理器設定 (Package Manager Setup)
|
|||
|
|
|
|||
|
|
為此專案或全域環境設定您偏好的套件管理器。
|
|||
|
|
|
|||
|
|
## 使用方式
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 偵測目前的套件管理器
|
|||
|
|
node scripts/setup-package-manager.js --detect
|
|||
|
|
|
|||
|
|
# 設定全域偏好
|
|||
|
|
node scripts/setup-package-manager.js --global pnpm
|
|||
|
|
|
|||
|
|
# 設定專案偏好
|
|||
|
|
node scripts/setup-package-manager.js --project bun
|
|||
|
|
|
|||
|
|
# 列出可用的套件管理器
|
|||
|
|
node scripts/setup-package-manager.js --list
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 偵測優先順序
|
|||
|
|
|
|||
|
|
在判定使用哪個套件管理器時，會依序檢查：
|
|||
|
|
|
|||
|
|
1. **環境變數**：`CLAUDE_PACKAGE_MANAGER`
|
|||
|
|
2. **專案配置**：`.claude/package-manager.json`
|
|||
|
|
3. **package.json**：`packageManager` 欄位
|
|||
|
|
4. **鎖定檔案 (Lock file)**：是否存在 package-lock.json, yarn.lock, pnpm-lock.yaml 或 bun.lockb
|
|||
|
|
5. **全域配置**：`~/.claude/package-manager.json`
|
|||
|
|
6. **備選方案 (Fallback)**：第一個可用的套件管理器 (pnpm > bun > yarn > npm)
|
|||
|
|
|
|||
|
|
## 配置文件
|
|||
|
|
|
|||
|
|
### 全域配置
|
|||
|
|
```json
|
|||
|
|
// ~/claude/package-manager.json
|
|||
|
|
{
|
|||
|
|
"packageManager": "pnpm"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 專案配置
|
|||
|
|
```json
|
|||
|
|
// claude/package-manager.json
|
|||
|
|
{
|
|||
|
|
"packageManager": "bun"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### package.json
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"packageManager": "pnpm@8.6.0"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 環境變數
|
|||
|
|
|
|||
|
|
設定 `CLAUDE_PACKAGE_MANAGER` 以覆蓋所有其他偵測方法：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Windows (PowerShell)
|
|||
|
|
$env:CLAUDE_PACKAGE_MANAGER = "pnpm"
|
|||
|
|
|
|||
|
|
# macOS/Linux
|
|||
|
|
export CLAUDE_PACKAGE_MANAGER=pnpm
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 執行偵測
|
|||
|
|
|
|||
|
|
若要查看目前的套件管理器偵測結果，請執行：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
node scripts/setup-package-manager.js --detect
|
|||
|
|
```
|