如何在TYPO3-9.5.31（XAMPP本地环境）中适配链接路径？

当前项目输出的静态资源链接缺少project_name/public前缀，示例错误链接：

<link rel="stylesheet" type="text/css" href="http://localhost/fileadmin/templates/css/fonts.css?1580323512" media="all">

期望的正确链接格式：

<link rel="stylesheet" type="text/css" href="http://localhost/project_name/public/fileadmin/templates/css/fonts.css?1580323512" media="all">

可通过以下步骤修复：

• 修正TYPO3站点根URL配置
  进入TYPO3后台「站点管理」，编辑对应站点，在「基础」标签下将「站点根URL」设为http://localhost/project_name/public/（注意末尾保留斜杠），保存后清除全部缓存。

• 配置Apache虚拟主机（推荐）
  编辑XAMPP下apache/conf/extra/httpd-vhosts.conf，添加项目虚拟主机配置，将DocumentRoot直接指向项目的public目录：

  <VirtualHost *:80>
      ServerName typo3-project.local
      DocumentRoot "C:/xampp/htdocs/project_name/public"
      <Directory "C:/xampp/htdocs/project_name/public">
          AllowOverride All
          Require all granted
      </Directory>
  </VirtualHost>
  

  接着在本地hosts文件中添加映射127.0.0.1 typo3-project.local，重启Apache后用自定义域名访问，资源路径会自动匹配public目录。

• 检查LocalConfiguration.php中的基础URL配置
  打开项目根目录下的typo3conf/LocalConfiguration.php，确保SYS节点下的baseURL或siteURL设置正确：

  'SYS' => [
      'baseURL' => 'http://localhost/project_name/public/',
  ],
  

  修改后清除TYPO3缓存生效。

• 规范资源引用方式
  模板中避免硬编码资源路径，使用TYPO3内置方法生成链接：

  • Fluid模板用视图助手：<f:stylesheet href="fileadmin/templates/css/fonts.css" />
  • TypoScript配置：page.includeCSS.fonts = fileadmin/templates/css/fonts.css
    这样系统会自动基于站点根URL拼接正确路径。

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