将 nx 从 23.x 升级到 24.x

根据 TypeScript 类型自动比较 nx 23.3.1 与 24.0.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	0
已删除的导出	0
已修改的签名	3
已删除的类或接口成员	12
已修改的类或接口成员	18
新增弃用	0
要求变化（engines、peer 依赖）	0
新增导出	40

已删除的导出

未发现。

已修改的签名

export	之前	之后
`nx/src/native · expandFilesInput`	`(workspaceRoot: string, globs: string[]): string[]`	`(workspaceRoot: string, globs: string[], projectRoots?: string[] \| null \| undefined): string[]`
`nx/src/native/index · expandFilesInput`	`(workspaceRoot: string, globs: string[]): string[]`	`(workspaceRoot: string, globs: string[], projectRoots?: string[] \| null \| undefined): string[]`
`nx/src/native/index.js · expandFilesInput`	`(workspaceRoot: string, globs: string[]): string[]`	`(workspaceRoot: string, globs: string[], projectRoots?: string[] \| null \| undefined): string[]`

已删除的类或接口成员

member	import	之前
`InvocationRecord.parentPid`	`nx/src/native`	`number`
`TaskInvocationTracker.getInvocationChain`	`nx/src/native`	`(): InvocationRecord[]`
`TaskUltracacheSettings.ignoredReads`	`nx/src/native`	`string[] \| undefined`
`TaskUltracacheSettings.ignoredWrites`	`nx/src/native`	`string[] \| undefined`
`InvocationRecord.parentPid`	`nx/src/native/index`	`number`
`TaskInvocationTracker.getInvocationChain`	`nx/src/native/index`	`(): InvocationRecord[]`
`TaskUltracacheSettings.ignoredReads`	`nx/src/native/index`	`string[] \| undefined`
`TaskUltracacheSettings.ignoredWrites`	`nx/src/native/index`	`string[] \| undefined`
`InvocationRecord.parentPid`	`nx/src/native/index.js`	`number`
`TaskInvocationTracker.getInvocationChain`	`nx/src/native/index.js`	`(): InvocationRecord[]`
`TaskUltracacheSettings.ignoredReads`	`nx/src/native/index.js`	`string[] \| undefined`
`TaskUltracacheSettings.ignoredWrites`	`nx/src/native/index.js`	`string[] \| undefined`

已修改的类或接口成员

member	之前	之后
`TaskGraph.dependencies`	`Record<string, string[]>`	`Record<string, TaskGraphEdge[]>`
`TaskGraph.continuousDependencies`	`Record<string, string[]>`	`Record<string, TaskGraphEdge[]>`
`AppLifeCycle.constructor`	`(tasks: Task[], initiatingTasks: string[], runMode: RunMode, pinnedTasks: string[], tuiCliArgs: TuiCliArgs, tuiConfig: TuiConfig, titleText: string, workspaceRoot: string, taskGraph: TaskGraph, isCloudEnabled?: boolean \| null \| undefined): AppLifeCycle`	`(tasks: Task[], initiatingTasks: string[], runMode: RunMode, pinnedTasks: string[], tuiCliArgs: TuiCliArgs, tuiConfig: TuiConfig, titleText: string, workspaceRoot: string, taskGraph: TaskGraph, readyDependencies: Record<string, string[]>, isCloudEnabled?: boolean \| null \| undefined): AppLifeCycle`
`TaskInvocationTracker.constructor`	`(db: ExternalObject<NxDbConnection>, rootPid: number): TaskInvocationTracker`	`(db: ExternalObject<NxDbConnection>, rootPid: number, ancestorPids: number[]): TaskInvocationTracker`
`TaskInvocationTracker.registerTask`	`(parentPid: number, taskId: string): void`	`(pid: number, taskId: string, overridesHash: string): InvocationRecord[] \| null`
`TaskInvocationTracker.unregisterTask`	`(taskId: string): void`	`(pid: number, taskId: string): void`
`TaskGraph.dependencies`	`Record<string, string[]>`	`Record<string, TaskGraphEdge[]>`
`TaskGraph.continuousDependencies`	`Record<string, string[]>`	`Record<string, TaskGraphEdge[]>`
`AppLifeCycle.constructor`	`(tasks: Task[], initiatingTasks: string[], runMode: RunMode, pinnedTasks: string[], tuiCliArgs: TuiCliArgs, tuiConfig: TuiConfig, titleText: string, workspaceRoot: string, taskGraph: TaskGraph, isCloudEnabled?: boolean \| null \| undefined): AppLifeCycle`	`(tasks: Task[], initiatingTasks: string[], runMode: RunMode, pinnedTasks: string[], tuiCliArgs: TuiCliArgs, tuiConfig: TuiConfig, titleText: string, workspaceRoot: string, taskGraph: TaskGraph, readyDependencies: Record<string, string[]>, isCloudEnabled?: boolean \| null \| undefined): AppLifeCycle`
`TaskInvocationTracker.constructor`	`(db: ExternalObject<NxDbConnection>, rootPid: number): TaskInvocationTracker`	`(db: ExternalObject<NxDbConnection>, rootPid: number, ancestorPids: number[]): TaskInvocationTracker`
`TaskInvocationTracker.registerTask`	`(parentPid: number, taskId: string): void`	`(pid: number, taskId: string, overridesHash: string): InvocationRecord[] \| null`
`TaskInvocationTracker.unregisterTask`	`(taskId: string): void`	`(pid: number, taskId: string): void`
`TaskGraph.dependencies`	`Record<string, string[]>`	`Record<string, TaskGraphEdge[]>`
`TaskGraph.continuousDependencies`	`Record<string, string[]>`	`Record<string, TaskGraphEdge[]>`
`AppLifeCycle.constructor`	`(tasks: Task[], initiatingTasks: string[], runMode: RunMode, pinnedTasks: string[], tuiCliArgs: TuiCliArgs, tuiConfig: TuiConfig, titleText: string, workspaceRoot: string, taskGraph: TaskGraph, isCloudEnabled?: boolean \| null \| undefined): AppLifeCycle`	`(tasks: Task[], initiatingTasks: string[], runMode: RunMode, pinnedTasks: string[], tuiCliArgs: TuiCliArgs, tuiConfig: TuiConfig, titleText: string, workspaceRoot: string, taskGraph: TaskGraph, readyDependencies: Record<string, string[]>, isCloudEnabled?: boolean \| null \| undefined): AppLifeCycle`
`TaskInvocationTracker.constructor`	`(db: ExternalObject<NxDbConnection>, rootPid: number): TaskInvocationTracker`	`(db: ExternalObject<NxDbConnection>, rootPid: number, ancestorPids: number[]): TaskInvocationTracker`
`TaskInvocationTracker.registerTask`	`(parentPid: number, taskId: string): void`	`(pid: number, taskId: string, overridesHash: string): InvocationRecord[] \| null`
`TaskInvocationTracker.unregisterTask`	`(taskId: string): void`	`(pid: number, taskId: string): void`

新增弃用

未发现。

要求变化（engines、peer 依赖）

未发现。

新增导出 (40)

import	export	kind
`nx/src/native`	`openUrl`	function
`nx/src/native`	`LogMatcher`	class
`nx/src/native`	`ShebangFile`	interface
`nx/src/native`	`TaskGraphEdge`	interface
`nx/src/native`	`TaskReadiness`	enum
`nx/src/native`	`ReadinessProbe`	class
`nx/src/native`	`SocketDirDetails`	interface
`nx/src/native`	`readShebangHeaders`	function
`nx/src/native`	`ReadinessProbeConfig`	interface
`nx/src/native`	`resolveDaemonSocketPath`	function
`nx/src/native`	`resolvePluginSocketPath`	function
`nx/src/native`	`resolveNxConsoleSocketPath`	function
`nx/src/native`	`resolveForkedProcessSocketPath`	function
`nx/src/native/index`	`openUrl`	function
`nx/src/native/index`	`LogMatcher`	class
`nx/src/native/index`	`ShebangFile`	interface
`nx/src/native/index`	`TaskGraphEdge`	interface
`nx/src/native/index`	`TaskReadiness`	enum
`nx/src/native/index`	`ReadinessProbe`	class
`nx/src/native/index`	`SocketDirDetails`	interface
`nx/src/native/index`	`readShebangHeaders`	function
`nx/src/native/index`	`ReadinessProbeConfig`	interface
`nx/src/native/index`	`resolveDaemonSocketPath`	function
`nx/src/native/index`	`resolvePluginSocketPath`	function
`nx/src/native/index`	`resolveNxConsoleSocketPath`	function
`nx/src/native/index`	`resolveForkedProcessSocketPath`	function
`nx/nx-cloud-internals`	`TASK_GRAPH_FORMAT`	variable
`nx/src/native/index.js`	`openUrl`	function
`nx/src/native/index.js`	`LogMatcher`	class
`nx/src/native/index.js`	`ShebangFile`	interface
`nx/src/native/index.js`	`TaskGraphEdge`	interface
`nx/src/native/index.js`	`TaskReadiness`	enum
`nx/src/native/index.js`	`ReadinessProbe`	class
`nx/src/native/index.js`	`SocketDirDetails`	interface
`nx/src/native/index.js`	`readShebangHeaders`	function
`nx/src/native/index.js`	`ReadinessProbeConfig`	interface
`nx/src/native/index.js`	`resolveDaemonSocketPath`	function
`nx/src/native/index.js`	`resolvePluginSocketPath`	function
`nx/src/native/index.js`	`resolveNxConsoleSocketPath`	function
`nx/src/native/index.js`	`resolveForkedProcessSocketPath`	function

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 nx 从 23 升级到 24 有哪些不兼容变更？

在 nx 23.3.1 与 24.0.0 之间，Vigia 发现 0 个已删除的导出、3 个已修改的签名，以及 30 个已删除或修改的类或接口成员。

nx 24 中弃用了哪些内容？

nx 24.0.0 中有 0 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/nx/upgrade?from=23.3.1&to=24.0.0