【架构优化】从 runtime.installNPMCLI 中拆出 npm 参数拼装 npmCLIInstallArgs 与安装结果启用 activateNPMStage

未關閉
#485 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

@fx-kurumi 已經在處理了。

開始於 2026年11月13日。

  • #487 來自 @fx-kurumi —— 未關閉

評估

難度
2/5
預估耗時
1-3 小時
新手友好度
30/100
Issue 類型
重構
描述清晰度
描述清楚
活躍度
活躍
技術堆疊
go
領域
tooling

研究方向

Start in internal/runtime/cli_ondemand.go, where installNPMCLI mixes directory setup, npm argument assembly and stage activation. Check open pull request #487 first, since work on this split may already be under way. Done means npmCLIInstallArgs and activateNPMStage exist as private helpers with unit tests, installNPMCLI keeps its signature, and go test ./internal/runtime/ passes.

由索引模型根據 Issue 內容生成。

描述

现状问题

internal/runtime/cli_ondemand.go 的 installNPMCLI 约 45 行,把三件事写在一个函数里:

  1. 准备安装目录与临时 stage 目录;
  2. 拼装 npm install 参数(--engine-strict / --engine-strict=false 依 RelaxEngines 切换)并执行;
  3. 校验 stage 内可执行文件、替换 current 目录、返回最终路径。

参数拼装是纯逻辑,却只能通过伪造 npm 可执行文件的集成测试间接覆盖;启用安装结果的逻辑也无法单独测试。

重构方案

  • 拆出纯函数 npmCLIInstallArgs(stage string, spec onDemandCLI) []string,负责参数拼装;
  • 拆出 activateNPMStage(parent, stage, binary string) (string, error),负责校验可执行文件、替换 current 并返回路径;
  • installNPMCLI 只保留目录准备、执行 npm 与调用上面两个函数,签名与调用方不变;参数顺序、报错文字逐字保持一致。

影响范围

仅 internal/runtime/cli_ondemand.go,包内私有函数,不影响对外接口和行为。

验证方式

  • 新增单元测试覆盖 npmCLIInstallArgs(严格/放宽 engines 两种)与 activateNPMStage(成功替换旧 current、缺可执行文件报错);
  • 现有 cli_ondemand_test.go 集成测试保持通过;
  • gofmt、go vet ./internal/runtime/、go test ./internal/runtime/。
主要語言
Go
星號
141
分支
28
平均合併
1 天 15 小時
30 天內合併 PR
113

環境準備

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

Tencent/LoopForge 的其他 Issue

查看 Tencent/LoopForge 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。