my-code-style 1.6.1 → 1.7.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## 变更日志
 
+## [1.7.0](https://github.com/myvn/codeStyle/compare/v1.6.1...v1.7.0) (2026-09-20)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **deps:** stylelint 生态 peer 放宽到 16/17 两条线，并补 Stylelint 17 运行时回归 ([a230edc](https://github.com/myvn/codeStyle/commit/a230edcae73d2b935977567b8f082aaaa74dc938))
+
+
+### ✨ Features | 新功能
+
+* **init:** 依赖版本体检 —— 已装但版本不匹配、上游配置 peer 冲突、parser 错位 ([2820834](https://github.com/myvn/codeStyle/commit/2820834bc3062900724132f7b29c2581eace13e8))
+* **init:** 版本体检精确到 minor —— 只比主版本会漏掉 10.2.0 vs ^10.3.0 ([d13629c](https://github.com/myvn/codeStyle/commit/d13629c947575109ed3319854ab902e5caada145))
+
 ### [1.6.1](https://github.com/myvn/codeStyle/compare/v1.6.0...v1.6.1) (2026-09-18)
 
 ## [1.6.0](https://github.com/myvn/codeStyle/compare/v1.4.0...v1.6.0) (2026-09-18)

package/README.md

@@ -185,13 +185,15 @@ npx my-code-style-init [--dry-run] [--backup] [--version|-v] [--help|-h]
 | 提交信息被拒（`type may not be empty` / `subject may not be empty`） | 提交信息需符合 conventional commits                        | 用 `pnpm cz` 交互式生成；header 上限 108 字符                                                                     |
 | 老项目已有 `.eslintrc.*`，init 只读退出                              | ESLint 版本与配置格式冲突时 CLI 拒绝写入                   | 先确认/迁移版本，再重跑 init                                                                                      |
 | `pnpm release` 之后如何发布                                          | `release` 只生成版本、CHANGELOG、提交与 tag                | 另行执行 `npm publish`                                                                                            |
+| 装完看到一片 `unmet peer` 警告，要不要管                            | npm 遇到不满足的 peer 会直接 ERESOLVE 拒装，pnpm 只打印 WARN 就装完 | 先看警告来自谁：`unmet peer … from my-code-style` 说明版本声明没跟上，先升级本包；来自别的包（如 `postcss-html@1.8.1` 却要 `^2`）按提示对齐。重跑 `init` 会主动体检（范围精确到 minor，例如 `vue-eslint-parser 10.2.0` 不满足 `^10.3.0`）并打印对齐命令 |
+| `stylelint` 该用 16 还是 17                                          | 两条线都支持：`stylelint ^16.24.0 \|\| ^17.0.0`                    | 16 线（`stylelint-config-recommended@17`）兼容面最广；17 线要 stylelint 17 + `config-recommended@18` + `recommended-scss@17` + `stylelint-order@7/8`，且 Node ≥ 22.12。两条线都有真实运行回归（集成套件跑 16 线，Stylelint 17 套件跑 17 线） |
 
 完整 FAQ（含更多场景与解释）见 [docs/manual.md](docs/manual.md#五使用中遇到的问题faq)。
 
 ## 测试套件
 
 ```bash
-npm run test:all               # 全量运行 152 项：用例明细 + 分类统计 + 最慢文件定位
+npm run test:all               # 全量运行 168 项：用例明细 + 分类统计 + 最慢文件定位
 npm run diagnose               # 换机器后先跑它：进程 / git / 文件系统 / hooks 各占多少
 npm run sweep                  # 给本机找最佳文件级并发（扫 integration 套件）
 npm test                       # 只跑基础 CLI 与配置矩阵（70 项）
@@ -199,6 +201,8 @@ npm run test:integration:setup # 安装现代化隔离依赖运行环境
 npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（55 项）
 npm run test:legacy:setup      # 安装 ESLint 8 隔离运行环境
 npm run test:legacy            # ESLint 8.57.0 兼容性回归测试（27 项）
+npm run test:stylelint17:setup # 安装 Stylelint 17 隔离运行环境
+npm run test:stylelint17       # Stylelint 17 生态兼容性回归（8 项）
 ```
 
 `npm run test:all` 由 `scripts/test-all.cjs` 驱动，输出**套件 → 用例 → 汇总**三层：
@@ -207,38 +211,44 @@ npm run test:legacy            # ESLint 8.57.0 兼容性回归测试（27 项）
 ```text
   my-code-style 测试套件
 
-  ▶ [1/3] 基础 CLI 与配置矩阵  （共 70 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [1/4] 基础 CLI 与配置矩阵  （共 78 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 运行器 TAP 解析：统计通过与失败、SKIP 与每用例耗时 · 2ms
-      ✓ 所有公共导出目标存在且可通过包名解析 · 11ms
-      ✓ Prettier 默认值和 JSON/YAML/nvue 文件例外 · 1ms
+      ✓ 依赖版本体检：两位数主版本（stylelint 17）不再被静默跳过 · 41ms
+      ✓ 所有公共导出目标存在且可通过包名解析 · 3ms
       …
-     ✓ 通过 70  ·  2.1s   · 最慢文件 init-matrix.test.cjs 1.9s
+     ✓ 通过 78  ·  3.2s   · 最慢文件 init-matrix.test.cjs 3.0s
 
-  ▶ [2/3] 现代工具链与提交链  （共 55 项，23 文件 · 3 文件并发（自动：2 核 / 内存 4G））
-      ✓ 完整提交链：JS/TS/Vue/nvue/CSS/scss 自动修复及二次复检 · 8.0s
-      ✓ 完整提交链拦截 nvue 内嵌样式错误（不是仅检查脚本） · 3.6s
+  ▶ [2/4] 现代工具链与提交链  （共 55 项，23 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+      ✓ 完整提交链：JS/TS/Vue/nvue/CSS/scss 自动修复及二次复检 · 10.7s
       ✓ Flat Config 启用 eslint:recommended 核心规则：no-debugger · 45ms
       …
-     ✓ 通过 55  ·  30.8s   · 最慢文件 commit-chain-both.test.cjs 8.4s
+     ✓ 通过 55  ·  42.7s   · 最慢文件 commit-chain-scss.test.cjs 11.4s
 
-  ▶ [3/3] ESLint 8 兼容性  （共 27 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
-      ✓ ESLint 8 base：生成的 lint 脚本遍历并拦截 broken.ts · 1.1s
+  ▶ [3/4] ESLint 8 兼容性  （共 27 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+      ✓ ESLint 8 base：生成的 lint 脚本遍历并拦截 broken.ts · 1.3s
       …
-     ✓ 通过 27  ·  14.3s
+     ✓ 通过 27  ·  19.0s
+
+  ▶ [4/4] Stylelint 17 兼容性  （共 8 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+      ✓ stylelint 17 下 --fix 生效且幂等（SCSS） · 1.4s
+      ✓ stylelint-order（recess-order 7 的 peer）在 stylelint 17 下可用 · 1.0s
+      …
+     ✓ 通过 8  ·  7.4s
 
   ──────────────────────────────────────────────────────
   套件                      通过    失败    跳过    用时
   ──────────────────────────────────────────────────────
-  基础 CLI 与配置矩阵         70       0       -    2.1s
-  现代工具链与提交链          55       0       -   30.8s
-  ESLint 8 兼容性             27       0       -   14.3s
+  基础 CLI 与配置矩阵         78       0       -    3.2s
+  现代工具链与提交链          55       0       -   42.7s
+  ESLint 8 兼容性             27       0       -   19.0s
+  Stylelint 17 兼容性          8       0       -    7.4s
   ──────────────────────────────────────────────────────
-  合计                       152       0       -   47.2s
+  合计                       168       0       -   72.3s
   ──────────────────────────────────────────────────────
 
-  ⏱ 最慢文件：eslint8.test.cjs 14.3s · commit-chain-both.test.cjs 8.4s · commit-chain-scss.test.cjs 8.3s
+  ⏱ 最慢文件：eslint8.test.cjs 19.0s · commit-chain-scss.test.cjs 11.4s · commit-chain-less.test.cjs 11.1s
 
-  ✅ 全部通过：152/152 项，用时 47.2s
+  ✅ 全部通过：168/168 项，用时 72.3s
 ```
 
 
@@ -248,7 +258,7 @@ npm run test:legacy            # ESLint 8.57.0 兼容性回归测试（27 项）
 | 参数                 | 作用                                                          |
 | -------------------- | ------------------------------------------------------------- |
 | `-- --quiet`         | 只看套件结论与汇总表，不列用例明细（长输出时用）                |
-| `-- --parallel`      | 强制三个套件同时跑（核数 ≥ 8 时默认已自动开启）                 |
+| `-- --parallel`      | 强制四个套件同时跑（核数 ≥ 8 时默认已自动开启）                 |
 | `-- --serial`        | 强制串行（CI 形态，输出顺序最稳定）                             |
 | `-- --jobs=2`        | 配合并行限制同时运行的套件数，其余排队（面板显示"等待中"）      |
 | `-- --suite=base,legacy` | 只跑指定套件（base / integration / legacy，逗号分隔）       |
@@ -280,7 +290,8 @@ npm run test:all -- --profile     # 看每个测试文件耗时，定位瓶颈
 - **文件级**：集成套件按"一条提交链一个文件"拆成 23 个测试文件，**由运行器自己按文件
   调度**（每个文件一个 `node --test` 进程），不依赖 Node 的 `--test` 默认并发值——
   同一个文件内的用例仍然串行（真实 git 仓库不能并行改），文件之间才是并发的。
-- **套件级**：三个套件再并行，互不共享目录。
+- **套件级**：四个套件再并行，互不共享目录（基础只碰系统临时目录，集成用
+  `demo-test/.runtime`，ESLint 8 用 `.runtime-legacy`，Stylelint 17 用 `.runtime-sl17`）。
 
 因为每个文件里跑的都是真实 `git commit`（单次 0.5–3.9s），墙钟由**最慢的那个文件**
 决定，所以文件尽量拆到"一个文件一次提交"。每个套件跑完会直接告诉你最慢文件是谁，
@@ -306,13 +317,13 @@ npm run test:all -- --profile     # 看每个测试文件耗时，定位瓶颈
 并发 git/npx 撑到 OOM（进程被 SIGKILL）；文件数多于并发数时，**用例少的文件（多半是同
 一条重链）优先开跑**，避免长任务被排进最后一波、墙钟再多乘一倍。
 
-实测（2 核沙箱，152 项；沙箱内存 4G，所以自动并发是 3）：
+实测（2 核沙箱，168 项；沙箱内存 4G，所以自动并发是 3）：
 
 | 运行方式                            | 墙钟时间                                        |
 | ----------------------------------- | ----------------------------------------------- |
 | 串行套件 + 文件级并发 1（CI 旧形态） | 62.4s（hook 改造前同配置 70.3s）                |
 | 串行套件 + 自动并发 3（默认）        | 47.2s（hook 改造前同配置 51.8s）                |
-| `--parallel` 三套件 + 自动并发 3     | 43.0s（hook 改造前同配置 46.6s）                |
+| `--parallel` 四套件 + 自动并发 3     | 43.0s（hook 改造前同配置 46.6s）                |
 | `node --test demo-test/integration/*.test.cjs`（Node 自己调度，等同旧命令） | 43.7s（只看集成套件那一段）      |
 | `npm run test:integration`（运行器调度，自动并发 3） | 30.6s（只看集成套件那一段）                    |
 | 串行套件 + 文件级并发 23（全部一波） | ✗ 3.8G 内存沙箱被 OOM 压垮（19 项 SIGKILL）      |

package/bin/init

@@ -211,6 +211,25 @@ function rangeIntervals(range) {
     return intervals
 }
 
+/**
+ * 判断某个具体版本（含 minor / patch）是否落在声明的范围内。
+ *
+ * 为什么不用主版本判断：`vue-eslint-parser ^10.3.0` 与装到的 10.2.0 主版本相同，
+ * 但 10.3 才是 Vue 插件 10 的兼容下限，只比主版本会漏掉这类 minor 级错位。
+ * 这里直接做区间相交判断，既不受主版本位数限制（stylelint 16/17），也不丢 minor。
+ * 返回 null 表示范围无法解析（不判断）。
+ */
+function satisfiesRange(range, version) {
+    const parts = parseVersionFields(version)
+    if (!parts || parts.some((part) => part === null)) return null
+    const target = lowerBound(parts)
+    const intervals = rangeIntervals(range)
+    if (!intervals.length) return null
+    return intervals.some(
+        ([lower, upper]) => compareVersion(lower, target) <= 0 && compareVersion(target, upper) < 0,
+    )
+}
+
 /**
  * List every major version a declared range can install (0-12), or null when
  * the range cannot be parsed.
@@ -233,18 +252,13 @@ function majorsForRange(range) {
 }
 
 /**
- * Read the actually installed ESLint major version. In a monorepo the binary is
- * usually hoisted to the workspace root, so walk up to 8 levels; a version is
- * only accepted from the project root itself or from an ancestor that looks
- * like a workspace root (package.json / pnpm-workspace.yaml / lerna.json).
+ * 读取任意包在本项目（或向上寻找的“工作区根”）里实际安装的版本。
+ * monorepo 里依赖常被提升到工作区根，所以要向上走；只采纳项目根或带
+ * manifest 的祖先目录，避免把无关上级目录的 node_modules 当成本项目依赖。
  */
-function findInstalledEslintMajor(rootDir) {
+function findInstalledPackage(pkgName, rootDir) {
     let dir = rootDir
     for (let depth = 0; depth < 8; depth += 1) {
-        // 只采纳项目根或“像工作区根”的祖先里的安装（package.json / pnpm-workspace.yaml /
-        // lerna.json）。中间层（如 monorepo 的 packages/）通常没有任何 manifest，
-        // 必须继续向上找；而完全无关的上级目录（例如 /tmp 或 $HOME 的 node_modules）
-        // 即使存在 eslint 也不能当作项目依赖。
         const isProjectRoot = dir === rootDir
         const isWorkspaceRoot =
             fs.existsSync(path.resolve(dir, "package.json")) ||
@@ -253,16 +267,20 @@ function findInstalledEslintMajor(rootDir) {
 
         if (isProjectRoot || isWorkspaceRoot) {
             try {
-                const installedPkgPath = path.resolve(dir, "node_modules", "eslint", "package.json")
-                if (fs.existsSync(installedPkgPath)) {
-                    const installedPkg = JSON.parse(fs.readFileSync(installedPkgPath, "utf8"))
-                    const installedMajor = parseInt(String(installedPkg.version).split(".")[0], 10)
-                    if (!Number.isNaN(installedMajor)) {
-                        return installedMajor
+                const manifestPath = path.resolve(
+                    dir,
+                    "node_modules",
+                    ...pkgName.split("/"),
+                    "package.json",
+                )
+                if (fs.existsSync(manifestPath)) {
+                    const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"))
+                    if (manifest.version) {
+                        return { version: String(manifest.version), dir, manifest }
                     }
                 }
             } catch {
-                // ignore unreadable/partial installs and keep walking up
+                // 忽略读不动的安装（半装状态），继续向上找
             }
         }
 
@@ -273,6 +291,16 @@ function findInstalledEslintMajor(rootDir) {
     return null
 }
 
+/**
+ * 读取实际安装的 ESLint 主版本号（见 findInstalledPackage 的查找规则）。
+ */
+function findInstalledEslintMajor(rootDir) {
+    const installed = findInstalledPackage("eslint", rootDir)
+    if (!installed) return null
+    const major = parseInt(String(installed.version).split(".")[0], 10)
+    return Number.isNaN(major) ? null : major
+}
+
 /**
  * Detect ESLint major version from the installed package or the declared range.
  * Returns 8, 9, 10, … or null (not installed and no usable range).
@@ -1194,6 +1222,8 @@ function checkPeerDeps({
         ...(pkg.devDependencies || {}),
     }
 
+    checkInstalledVersions({ peerDeps, allPeerDeps })
+
     const missing = allPeerDeps.filter((dep) => !allDeps[dep])
     if (missing.length > 0) {
         console.log("")
@@ -1211,6 +1241,109 @@ function checkPeerDeps({
     }
 }
 
+// 体检时会顺着这些包的 peerDependencies 反查底层依赖的实际版本
+const PEER_SOURCE_PACKAGES = [
+    "stylelint-config-recommended",
+    "stylelint-config-recommended-scss",
+    "stylelint-config-recommended-vue",
+    "stylelint-config-html",
+    "stylelint-config-recess-order",
+    "stylelint-prettier",
+]
+// 只反查这些“装错就真的会坏”的底层包，避免把上游配置之间的宽松约束也报出来
+const PEER_SOURCE_TARGETS = [
+    "stylelint",
+    "stylelint-order",
+    "postcss-html",
+    "stylelint-config-recommended",
+    "stylelint-config-html",
+    "stylelint-config-recommended-scss",
+]
+
+/**
+ * 已装依赖的版本体检。
+ *
+ * 为什么需要它：npm 遇到不满足的 peer 会直接 ERESOLVE 拒装，pnpm 只打印一行
+ * WARN 就装完，于是“装是装上了，跑起来才坏”的组合会长期潜伏。这里把两类问题
+ * 主动查出来并给出对齐命令（只做 major 级别判断，保持零依赖）：
+ *   1. 我们声明的 peer 范围 vs 项目里实际安装的版本（含 minor / patch）；
+ *   2. 上游配置包自己的 peer（例如 stylelint-config-recommended@18 要求
+ *      stylelint ^17），以及 typescript-eslint 与其 parser/plugin 的版本错位。
+ */
+function checkInstalledVersions({ peerDeps, allPeerDeps, rootDir = PROJECT_ROOT }) {
+    const problems = [];
+    const seen = new Set();
+    const add = (name, message, target) => {
+        const key = `${name}\u0000${message}`;
+        if (seen.has(key)) return;
+        seen.add(key);
+        problems.push({ name, message, target });
+    };
+    const minorOf = (version) => String(version).split(".").slice(0, 2).join(".");
+
+    // 1) 本工具的 peer 范围 vs 实际安装
+    for (const dep of allPeerDeps) {
+        const range = dep === "eslint" ? peerDeps.eslint : peerDeps[dep];
+        if (!range || range === "*" || range.startsWith("npm:")) continue;
+        const installed = findInstalledPackage(dep, rootDir);
+        if (!installed) continue;
+        const allowed = satisfiesRange(range, installed.version);
+        if (allowed === null || allowed) continue;
+        add(dep, `${dep} 装了 ${installed.version}，本工具要求 ${range}`, `${dep}@${range}`);
+    }
+
+    // 2) 上游配置包的 peer vs 实际安装（配置文件本身也会挑底层版本）
+    for (const dep of PEER_SOURCE_PACKAGES) {
+        const source = findInstalledPackage(dep, rootDir);
+        if (!source) continue;
+        for (const [target, range] of Object.entries(source.manifest.peerDependencies || {})) {
+            if (!PEER_SOURCE_TARGETS.includes(target)) continue;
+            if (range === "*" || String(range).startsWith("npm:")) continue;
+            const installed = findInstalledPackage(target, rootDir);
+            if (!installed) {
+                if (!rangeIntervals(range).length) continue;
+                add(
+                    target,
+                    `${dep}@${source.version} 需要 ${target}@${range}，项目里没有安装`,
+                    `${target}@${range}`,
+                );
+                continue;
+            }
+            const allowed = satisfiesRange(range, installed.version);
+            if (allowed === null || allowed) continue;
+            add(
+                target,
+                `${dep}@${source.version} 要求 ${target}@${range}，实际装了 ${installed.version}`,
+                `${target}@${range}`,
+            );
+        }
+    }
+
+    // 3) typescript-eslint 与 @typescript-eslint/parser、eslint-plugin 必须同版本
+    const meta = findInstalledPackage("typescript-eslint", rootDir);
+    if (meta) {
+        for (const sibling of ["@typescript-eslint/parser", "@typescript-eslint/eslint-plugin"]) {
+            const installed = findInstalledPackage(sibling, rootDir);
+            if (!installed) continue;
+            if (minorOf(installed.version) === minorOf(meta.version)) continue;
+            add(
+                sibling,
+                `${sibling}@${installed.version} 与 typescript-eslint@${meta.version} 不是同一版本`,
+                `${sibling}@${meta.version}`,
+            );
+        }
+    }
+
+    if (!problems.length) return;
+    console.log("");
+    warn("以下依赖已安装，但版本与当前配置不匹配：");
+    for (const problem of problems) console.log(`  · ${problem.message}`);
+    console.log("");
+    warn("对齐命令（也可以把上游配置包降到与你现有版本匹配的大版本）：");
+    const targets = [...new Set(problems.map((problem) => problem.target))];
+    console.log(`  ${addDevCommand(detectPackageManager())} ${targets.join(" ")}`);
+}
+
 // Only run when executed directly; requiring this file must be side-effect free.
 if (require.main === module) {
     main()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-code-style",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "description": "Lint/Format/Git 配置工程化 npm 包（ESLint + Prettier + Stylelint + Commitlint + Husky + standard-version）",
   "type": "commonjs",
   "main": "src/eslint/uniapp.cjs",
@@ -47,7 +47,9 @@
     "test:integration:setup": "node demo-test/setup-integration.cjs",
     "test:integration": "node scripts/test-all.cjs --suite=integration",
     "test:legacy:setup": "node demo-test/setup-legacy.cjs",
+    "test:stylelint17:setup": "node demo-test/setup-stylelint17.cjs",
     "test:legacy": "node scripts/test-all.cjs --suite=legacy",
+    "test:stylelint17": "node scripts/test-all.cjs --suite=stylelint17",
     "test:all": "node scripts/test-all.cjs",
     "diagnose": "node scripts/diagnose-speed.cjs",
     "sweep": "node scripts/sweep-concurrency.cjs",
@@ -88,12 +90,13 @@
     "postcss-scss": "^4.0.0",
     "prettier": "^3.0.0",
     "standard-version": "^9.0.0",
-    "stylelint": "^16.0.0",
+    "stylelint": "^16.24.0 || ^17.0.0",
     "stylelint-config-html": "^2.0.0",
-    "stylelint-config-recess-order": "^5.0.0",
-    "stylelint-config-recommended": "^17.0.0",
-    "stylelint-config-recommended-scss": "^16.0.0",
+    "stylelint-config-recess-order": "^5.0.0 || ^6.0.0 || ^7.0.0",
+    "stylelint-config-recommended": "^17.0.0 || ^18.0.0",
+    "stylelint-config-recommended-scss": "^16.0.0 || ^17.0.0",
     "stylelint-config-recommended-vue": "^2.0.0",
+    "stylelint-order": "^6.0.0 || ^7.0.0 || ^8.0.0",
     "stylelint-prettier": "^5.0.0",
     "typescript": "^5.0.0",
     "typescript-eslint": "^8.0.0",
@@ -181,6 +184,9 @@
     "stylelint-config-recommended-vue": {
       "optional": true
     },
+    "stylelint-order": {
+      "optional": true
+    },
     "stylelint-prettier": {
       "optional": true
     },