分类： Ruby/Rails开发工具
-
本文记录了在 WSL2 的 Ubuntu-20.04 环境中安装 Shopify CLI 3.0 的过程。作者通过更新系统并使用 Node.js 源解决了版本过低问题，随后重置系统并利用 rbenv 脚本成功安装了符合要求的 Ruby 3.2.2。期间解决了编译工具缺失等依赖问题，最终确认包括开发环境、Git 等所有要求均满足，完成了环境准备。
-
本文记录了在 Windows 10 专业版中将 Shopify CLI 从 2.x 迁移至 3.x 的过程。因直接运行升级命令失败且 Node.js 环境已就绪，操作采用先卸载旧版本再安装新版本的方法。作者通过 gem uninstall shopify-cli 移除了基于 RubyGems 的旧版 CLI，随后全局安装了 @shopify/cli 和 @shopify/theme Node.js 程序包。最终通过命令验证，版本号确认为 3.40.1，成功完成迁移与升级。
-
本文记录了在 Windows 10 专业版中基于 Node.js 安装 Shopify CLI 3.0 的准备与操作过程。作者参考官方文档要求，逐一检查了本地 Node.js、Ruby+Devkit 及 Bundler 的版本，确认均符合最低标准。通过命令行全局安装了 @shopify/cli 和 @shopify/theme 程序包后，执行验证命令发现当前版本为 2.x，后续仍需迁移至 3.x 版本以完成安装。
-
在PhpStorm中格式化Homestead.yaml文件后，发现缩进格式与Homestead.yaml.example不一致。通过参考官方文档，进入设置中的编辑器、代码样式与YAML选项，禁用了可能重写设置的EditorConfig。再次执行格式化操作后，文件缩进基本恢复为与示例文件一致的状态。
-
启动 vagrant 时报错 WHvCapabilityCodeHypervisorPresent 为 FALSE，提示需要启用 Windows Hypervisor Platform 功能。解决方法是在 Windows 系统中进入程序和功能，打开或关闭 Windows 功能，勾选 Windows 虚拟机监控程序平台并确认安装。安装完成后重启计算机，再次启动 vagrant 问题解决，不再报错。
-
启动 Vagrant 时报错 Psych::SyntaxError，提示 Homestead.yaml 文件第 10 行存在违规的制表符。经 PhpStorm 检查发现文件因曾被 EditPlus 编辑而产生红色波浪线提示。在 PhpStorm 中重新格式化该 YAML 文件后，编辑器内的错误提示消失，再次执行启动操作时不再报错，问题得到解决。
-
在 Shopify 应用中运行 yarn dev 时出现 Bundler version 2.3.7 is not supported 报错，这是由于 Bundler 版本不兼容导致的。通过运行 gem install bundler 命令将 Bundler 更新到最新版本后，再次执行 yarn dev 即可解决该问题，项目恢复正常运行。
-
遇到 Vagrant 报错提示等待机器启动超时，导致无法与客户机通信。尽管已经将共享目录映射修改为 E 盘路径，但问题仍未解决。最终通过创建新的 ~/Code 目录并执行 vagrant reload –provision 命令，成功重新启动并配置了虚拟机，不再出现报错。
-
在执行 vagrant up 时遇到报错，提示无法设置虚拟机名称，因为 VirtualBox 报告已存在同名虚拟机。解决方法是先删除 vagrant，随后打开 VirtualBox 图形界面确认并手动删除该虚拟机。接着根据提示删除指定目录下的虚拟机文件夹，再次执行 vagrant up 后不再报错，问题成功解决。
-
在使用 Homestead v13.2.1 运行项目时，因默认 PHP 8.0 版本与软件包依赖冲突导致 Composer 更新报错。通过修改 Homestead.yaml 配置指定站点 PHP 版本，并执行 vagrant reload –provision 重启虚拟机。在解决共享文件夹为空的问题后，下载 composer.phar 并使用 php7.4 命令执行更新，最终成功切换至 PHP 7.4.14，访问首页确认环境符合预期。