Magento模块激活必须先写registration.php和module.xml，否则bin/magento setup:upgrade会跳过；module.xml需置于etc/下且name大小写严格匹配，启用后须用module:status确认。
从 registration.php 和 module.xml 开始写，不是从“Hello World”页面开始
Magento 2 的模块激活机制很刚性：没有 registration.php，系统压根不认你这个目录是模块；没有 module.xml 里的 setup_version，bin/magento setup:upgrade 就会跳过它。很多初学者卡在“我写了控制器但 URL 404”，根本原因是 registration.php 文件权限不对（必须是 PHP 可执行）、或者 module.xml 放错了路径（必须在 etc/ 下，不是 etc/adminhtml/）。
-
registration.php必须用\Magento\Framework\Component\ComponentRegistrar::register()，不能用require_once手动加载 -
module.xml中的name属性必须和命名空间完全一致，比如Vendor_Module，大小写错一个字母，setup:upgrade就静默失败 - 写完立刻跑
bin/magento module:status | grep Vendor_Module确认是否列在 “List of enabled modules” 里
别在 Block 里写业务逻辑，Helper 和 Repository 才是干活的地方
新手常把所有东西塞进 Block 类：查订单、格式化价格、拼接 URL……结果一换模板就全崩。Block 的唯一职责是为模板提供数据，不是做判断、不调 API、不改数据库。真正该放逻辑的地方是：
-
Helper类：放无状态工具函数，比如formatSkuForDisplay()、isEligibleForFreeShipping()，它能被任何地方依赖注入，且不绑定生命周期 -
Repository接口 + 实现类：操作实体（Order、Product），比如OrderRepositoryInterface::get()或自定义的CustomOrderRepository::cancelPartially()，这才是改订单状态该走的路 - 千万别在 Block 构造函数里调
$this->orderRepository->get($id)后直接->cancel()—— 这违反了命令查询分离，也绕过了事件钩子（如sales_order_cancel_after）
取消订单别直接 $order->cancel()，先检查 canCancel() 和状态流转约束
直接调 $order->cancel()->save() 看似简单，但 Magento 2 的订单取消不是布尔开关。它受当前状态、发票/发货/退款进度、支付网关回调状态共同约束。硬取消可能抛出 StateException 或静默失败。
- 必须先调
$order->canCancel()—— 它内部检查state === 'new' || state === 'pending_payment'等条件，返回false就别往下走了 - 部分商品取消后整单标记为 canceled，要遍历
$order->getAllVisibleItems()，统计$item->getQtyCanceled() >= $item->getQtyOrdered()的数量，而不是只看$item->getStatus() === 'canceled' - 真实生产环境还要考虑并发：两个请求同时尝试取消同一订单，得靠数据库行锁或乐观锁（
version_id字段）防重复操作，OrderRepository::save()默认不带重试
调试时优先看 var/log/system.log 和 var/log/exception.log，不是浏览器控制台
Magento 的错误堆栈极长，但关键线索往往藏在日志最底下那行。比如 “Class does not exist” 看似是自动加载问题，实际可能是 di.xml 里 <type name="..."></type> 写错了类名，或者 use 语句漏了 \。浏览器 500 页面只显示“Something went wrong”，没用。
立即学习“PHP免费学习笔记（深入）”；
- 开开发者模式：
bin/magento dev:source-theme:deploy -f+bin/magento deploy:mode:set developer，否则连模板路径错误都看不到 - 临时加日志别用
echo或die()—— 用$this->logger->info('debug msg', ['order_id' => $order->getId()]);，它会自动打时间戳、上下文、进程 ID - 查 DI 问题？运行
bin/magento setup:di:compile --generate-directory=generated/code，编译失败的提示比运行时报错更直白
$order->cancel() —— 顺序错了，三天都搞不定。 
