如何将Aurelia CLI项目从v0.24.0升级至v1.2.3？求最优方案

升级这么大的版本跨度（从v0.x到v1.x）确实容易踩坑，我整理了一套经过验证的步骤，帮你平稳完成升级：

1. 先做好备份，留好后路 #

• 别直接在原项目上操作！先把整个项目复制到一个备份文件夹，或者用Git打个标签（比如git tag pre-upgrade-v0.24.0），这样万一升级出问题，随时能回滚。

2. 替换CLI版本（全局+本地） #

旧版本的CLI和v1.x架构差异很大，必须先替换掉：

• 卸载全局旧CLI：npm uninstall -g aurelia-cli
• 卸载项目本地的旧CLI依赖：npm uninstall aurelia-cli --save-dev
• 安装指定的v1.2.3 CLI：npm install -g aurelia-cli@1.2.3，然后给项目本地也装上：npm install aurelia-cli@1.2.3 --save-dev

3. 迁移配置文件（核心步骤） #

v1.x的CLI把配置结构从根目录的aurelia.json移到了aurelia_project/文件夹下，而且配置格式也变了。最稳妥的方式是用CLI的初始化命令来生成新配置：

• 在项目根目录运行au new --here
• 运行时会提示你选择模块加载器（SystemJS/Webpack，选和你原项目一致的）、是否用TypeScript、测试框架等，尽量匹配原项目的配置
• 遇到文件覆盖提示时，源码文件（比如src/下的）千万别覆盖，只覆盖配置相关的文件（比如aurelia_project/下的、根目录的package.json如果提示的话，你可以先对比差异再决定，或者之后手动合并依赖）

4. 更新项目依赖 #

旧版本的Aurelia核心包和工具链依赖可能和v1.x不兼容，得同步更新：

• 打开package.json，把所有aurelia-*开头的依赖版本更新到v1.x稳定版（CLI v1.2.3对应的框架版本一般是v1.3.x左右，你可以直接用^1.3.0这样的版本范围）
• 检查工具链依赖：比如Babel如果是旧版（v6及以下），要升级到v7+；Webpack如果用的话，要升级到v4或v5（看CLI的兼容版本）；TypeScript也要确保是兼容的版本
• 删除node_modules和package-lock.json（或yarn.lock），然后重新运行npm install，避免依赖缓存导致的冲突

5. 调整启动与源码适配 #

v1.x的启动逻辑和旧版本有细微差异，需要检查：

• 打开src/main.js（或main.ts），确保启动代码符合v1.x的规范，比如：

  import { Aurelia } from 'aurelia-framework';
  import { PLATFORM } from 'aurelia-pal';
  
  export function configure(aurelia) {
    aurelia.use
      .standardConfiguration()
      .developmentLogging();
  
    aurelia.start().then(() => aurelia.setRoot(PLATFORM.moduleName('app')));
  }
  

• 检查index.html，确保加载脚本的路径正确，比如SystemJS的配置文件路径是否指向了aurelia_project/aurelia.json

6. 测试构建与运行 #

完成上面的步骤后，先尝试构建和运行：

• 运行au build，看是否有编译错误，根据错误提示调整（比如模块找不到就检查配置里的路径，语法错误就调整Babel/TypeScript配置）
• 运行au run --watch，启动开发服务器，检查页面是否能正常加载，功能是否正常

7. 处理自定义任务与插件 #

如果你的项目用了自定义CLI任务或者第三方Aurelia插件：

• 自定义任务：v1.x的任务API和v0.x完全不同，需要重新编写任务代码，参考CLI的官方文档里的任务编写指南
• 第三方插件：确认插件是否支持v1.x的CLI，不支持的话要么找替代方案，要么修改插件代码适配新的CLI架构

如果运行时还是有报错，先仔细看错误信息——比如“模块找不到”大概率是配置路径不对，“语法错误”可能是工具链配置没跟上，“运行时异常”可能是框架API的小变化（不过v1.x对v0.x的API兼容度还不错，大部分代码不用改）。

内容的提问来源于stack exchange，提问作者Alex T