Parcel 不打包 JS/CSS 的根本原因是 index.html 未通过 或 显式声明相对路径依赖，且路径必须可静态解析；纯 HTML、绝对路径、内联脚本或命令执行位置错误均导致依赖图无法生成。
parcel build index.html 为什么没打包 JS/CSS？
根本原因：Parcel 并不“扫描整个项目”，它只从你传入的 HTML 文件里静态解析 <script src="xxx"></script> 和 <link href="xxx"> 标签，且路径必须可静态定位。如果这些标签缺失、路径写错或用了绝对路径，就等于没告诉 Parcel 入口依赖在哪。
-
index.html必须至少包含一个<script src="./xxx.js"></script>或<link rel="stylesheet" href="./xxx.css">—— 纯 HTML 不会触发任何转译或哈希 - 路径必须是相对路径（
./或../），/js/app.js这类绝对路径直接报Cannot resolve dependency - 命令必须在
index.html所在目录下运行，不能在父目录执行parcel build src/index.html却让src/index.html里写src="./main.js"（此时它会去找src/main.js相对于当前工作目录，而非 HTML 文件位置） - 内联
<script>console.log(1)</script>不会被打包或压缩，Parcel 当作纯文本处理
dev 模式下改 HTML 为啥整个页面刷新而不是局部更新？
HMR（热模块替换）对 HTML 文件本身不生效 —— 这不是 bug，是设计使然。Parcel 的 HMR 只作用于被 import 或 require 引入的 JS/CSS 模块。
- 修改
index.html：触发浏览器整页 reload（因为 HTML 是入口载体，变更后依赖图可能变化） - 修改
main.js或它import的 CSS：真正热替换，DOM 局部更新，控制台可见HMR: connection established - 想让样式局部生效，别写
<style>...</style>内联块，改用<link href="./style.css">或 JS 中import './style.css' - 确保开发服务器启动命令明确指定 HTML 文件：
"dev": "parcel index.html"，不是parcel serve或漏掉参数
build 后资源路径变成 /xxx.abc123.js，部署到子目录就 404 怎么办？
默认 --public-url 是 /，即根路径。如果你部署在 https://example.com/my-app/，浏览器会向根目录请求 /main.abc123.js，自然 404。
- 加参数强制设为相对路径：
parcel build index.html --public-url ./ - 效果：HTML 中的
<script src="main.js"></script>变成<script src="main.abc123.js"></script>（无前缀），所有资源相对于 HTML 位置加载 - 注意：这个参数只影响构建输出，不影响 dev server 的 URL 路由逻辑
- 如果用 CI/CD 自动构建，建议把该参数写进
package.jsonscripts："build": "parcel build index.html --public-url ./"
TS、JSX、图片 background-image 为啥不生效或报错？
零配置只覆盖最简 JS/CSS/HTML 场景。一旦涉及语法转换或非标准路径引用，Parcel 就需要对应生态支持 —— 它不会自动装插件，但会提示缺啥。
立即学习“前端免费学习笔记（深入）”；
- TypeScript：需本地安装
@parcel/transformer-typescript（v2）或@parcel/packager-ts（v3），否则报Cannot resolve module 'typescript' - JSX：同理，装
@parcel/transformer-react-refresh-wrap+@parcel/packager-html（v2）或开箱即用（v3+） - CSS 中
@import './reset.css'或url('./img/logo.png')：Parcel 默认不解析 CSS 里的相对路径上下文，容易 404；稳妥做法是统一用 JS import：import './reset.css';或import logo from './img/logo.png';，再通过 JS 注入 - 未被 HTML/JS 显式引用的静态文件（如
robots.txt、favicon.ico）：build 时不会自动复制，得手动放public/目录或加插件
