参考资料: https://stackoverflow.com/questions/79289166/something-is-wrong-with-my-react-installation-node-as-a-whole

问题:当使用 create-react-app时出现如下报错

npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: [email protected]
npm error Found: [email protected]
npm error node_modules/react
npm error   react@"^19.0.0" from the root project
npm error
npm error Could not resolve dependency:
npm error peer react@"^18.0.0" from @testing-library/[email protected]
npm error node_modules/@testing-library/react
npm error   @testing-library/react@"^13.0.0" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error C:\Users\chira\AppData\Local\npm-cache\_logs\2024-12-17T19_27_59_239Z-eresolve-report.txt
npm error A complete log of this run can be found in: C:\Users\chira\AppData\Local\npm-cache\_logs\2024-12-17T19_27_59_239Z-debug-0.log
`npm install --no-audit --save @testing-library/jest-dom@^5.14.1 @testing-library/react@^13.0.0 @testing-library/user-event@^13.2.1 web-vitals@^2.1.0` failed

原因可能是:

因为 React 上周刚刚更新到 v19,而 testing-library/react 还没有更新他们的依赖项要求。

解决:

使用 Vite 创建一个新的 React 应用程序。

npm create vite@latest

运行之后会让我们选择创建哪种模板,选择react之后再选择使用JavaScript即可。

安装hugo

windows

记得开管理员模式如果用cmd或者powershell,推荐用git bash

Chocolatey

choco install hugo-extended

choco安装hugo2

Scoop

scoop install hugo-extended

Winget

winget install Hugo.Hugo.Extended

Debian/Ubuntu

sudo apt install hugo

创建一个站点

hugo new site path/to/site

推荐在要想要放博客文件的文件夹下面使用下面这行命令:

hugo new site .

创建好之后的文件目录:
文件目录

.
├── archetypes: default.md是生成博文的模版
├── assets # 存放被 Hugo Pipes 处理的文件
├── content # 存放markdown文件作为博文内容
├── data # 存放 Hugo 处理的数据
├── layouts # 存放布局文件
├── static # 存放静态文件 图片 CSS JS文件
├── themes: 存放不同的主题
└── config.toml: 博客配置文件支持 JSON YAML TOML 三种格式配置文件

创建文章内容

创建一个文章内容页面

hugo new about.md

内容如下:

+++ 
date = "2015-01-08T08:36:54-07:00" 
draft = true 
title = "about" 
+++

只要将draft后面的参数改为false就是表示发布的意思

创建一篇文章

hugo new post/first.md

添加主题

官方主题仓库:https://themes.gohugo.io/

下载文件到本地

文件下载之后放入themes文件夹中,注意,假如有一个主题叫做heky,github上直接下载后解压得到的文件夹可能叫做heky-master,需要将后缀-master删除

git clone

在themes文件夹目录下,使用git clone 克隆仓库到本地

git submodule

关联主题仓库

要用这种方法,需要先在根目录用git init 创建一个仓库
git submodule add https://github.com/example/library.git libs/library

好处:可以使用以下命令更新主题
进行初始化:

git submodule update --init --recursive
克隆了别人的仓库进行修改之后,希望还原

需要同步主题仓库的最新修改:

git submodule update --remote

坏处是想删干净很麻烦:
假设你有一个子模块在路径 libs/library,你想移除它:
完整的操作是:

git submodule deinit -f libs/library
git rm --cached libs/library
rm -rf libs/library
rm -rf .git/modules/libs/library
git commit -m "Remove submodule libs/library"

三种方法都要在根目录下的 hugo.toml 文件中添加新的一行:

theme = "xxx"

运行Hugo

hugo server --theme=hyde --buildDrafts
参数说明:
--theme 后面跟想要的主题
--buildDrafts 表示草稿也一并显示

hugo默认开的端口是1313
所以可以通过浏览器打开 http://localhost:1313 来访问博客

hugo因为使用go语言来实现,所以运行速度很快,支持"热编写",即,在打开服务的情况下可以创建,或者修改内容,而不用重新启动服务。

同时如果是部署在服务器上,此时就可以通过配置反向代理,来完成博客搭建的收尾工作。

不过如果没有服务器的话要如何?下面来介绍如何利用github page来部署我们的hugo。

部署 Hugo 作为一个 Github Pages

第一步: 创建一个 Github 仓库

  1. 登录后,点击右上角,出现下拉菜单,点击 Your repositories 进入页面
  2. 点击 New
  3. 进入 Creat a new repository 页面
  4. Repository name 这里一定要填 [你的github账号].github.io.

第二步:创建新文章

hugo new posts/my-first-post.md

第三步:修改配置文件 config.toml

站点目录config.tomlbaseURL要换成自己建立的仓库,如baseURL = “https://xxx.github.io/"

第四步: 进入站点根目录下,执行:

hugo

执行后,站点根目录下会生成一个 public 文件夹,该文件下的内容即Hugo生成的整个静态网站。每次更新内容后,将 pubilc 目录里所有文件 push到GitHub即可。

第五步:上传代码至 master

首次使用的时候要执行以下命令:

cd public
git init
git remote add origin [email protected] #仓库地址
git add .
git commit -m "[介绍,随便写点什么,比如日期]"
git branch -M main
git push -u origin main
-u 表示将本地分支和远程分支关联,下次push时就可以不用显式的使用远程仓库名,而是可以直接用git push

之后就可以通过https://xxx.github.io/ 来访问我们的博客了。

以后每次站点目录下执行 hugo 命令后,再到public下执行推送命令:

git add .
git commit -m "[介绍,随便写点什么,比如日期]"
git push

自动化部署

通过上述命令我们可以手动发布我们的静态文件,但还是有以下弊端:

  1. 发布步骤还是比较繁琐,本地调试后还需要切换到 public/ 目录进行上传
  2. 无法对博客 .md 源文件进行备份与版本管理

因此,我们需要简单顺滑的方式来进行博客发布,首先我们初始化博客源文件的仓库,

因为我们的博客基于 GitHub 与 GitHub Pages,可以通过官方提供的 GitHub Action 进行 CI 自动发布,下面我会进行详细讲解。GitHub Action 是一个持续集成和持续交付(CI/CD) 平台,可用于自动执行构建、测试和部署管道,目前已经有很多开发好的工作流,可以通过简单的配置即可直接使用。

配置在仓库目录 .github/workflows 下,以 .yml 为后缀。
自动发布示例配置如下:

name: deploy

on:
    push:
    workflow_dispatch:
    schedule:
        # Runs everyday at 8:00 AM
        - cron: "0 0 * * *"

jobs:
    build:
        runs-on: ubuntu-latest
        steps:
            - name: Checkout
              uses: actions/checkout@v2
              with:
                  submodules: false
                  fetch-depth: 0

            - name: Setup Hugo
              uses: peaceiris/actions-hugo@v2
              with:
                  hugo-version: "latest"

            - name: Build Web
              run: hugo

            - name: Deploy Web
              uses: peaceiris/actions-gh-pages@v3
              with:
                  PERSONAL_TOKEN: ${{ secrets.PERSONAL_TOKEN }}
                  EXTERNAL_REPOSITORY: pseudoyu/pseudoyu.github.io
                  PUBLISH_BRANCH: main
                  PUBLISH_DIR: ./public
                  commit_message: ${{ github.event.head_commit.message }}

on 表示 GitHub Action 触发条件,我设置了 pushworkflow_dispatch 和 schedule 三个条件:

  • push,当这个项目仓库发生推送动作后,执行 GitHub Action
  • workflow_dispatch,可以在 GitHub 项目仓库的 Action 工具栏进行手动调用
  • schedule,定时执行 GitHub Action,如我的设置为北京时间每天早上执行,主要是使用一些自动化统计 CI 来自动更新我博客的关于页面,如本周编码时间,影音记录等,如果你不需要定时功能,可以删除这个条件

jobs 表示 GitHub Action 中的任务,我们设置了一个 build 任务,runs-on 表示 GitHub Action 运行环境,我们选择了 ubuntu-latest。我们的 build 任务包含了 CheckoutSetup HugoBuild Web 和 Deploy Web 四个主要步骤,其中 run 是执行的命令,uses 是 GitHub Action 中的一个插件,我们使用了 peaceiris/actions-hugo@v2 和 peaceiris/actions-gh-pages@v3 这两个插件。其中 Checkout 步骤中 with 中配置 submodules 值为 true 可以同步博客源仓库的子模块,即我们的主题模块。

首先需要将上述 deploy.yml 中的 EXTERNAL_REPOSITORY 改为自己的 GitHub Pages 仓库.

因为我们需要从博客仓库推送到外部 GitHub Pages 仓库,需要特定权限,要在 GitHub 账户下 Setting - Developer setting - Personal access tokens 下创建一个 Token。

问题背景

在前端开发中,尤其是本地开发时,我们常常直接通过双击 HTML 文件的方式使用浏览器打开网页,路径通常是 file:// 开头的 URL。例如:

file:///D:/web_study/20241217/index.html

在这种情况下,如果你尝试加载 JavaScript 文件,会遇到以下报错:

报错信息

Access to script at 'file:///D:/web_study/20241217/index.js' from origin 'null' has been blocked by CORS policy: 
Cross origin requests are only supported for protocol schemes: chrome, chrome-extension, chrome-untrusted, data, http, https, isolated-app.

GET file:///D:/web_study/20241217/index.js net::ERR_FAILED

报错解析

  1. CORS 限制:浏览器出于安全考虑,默认启用了同源策略(CORS)。当使用 file:// 协议时,浏览器无法确定源 (origin),因此请求被阻止。
  2. ERR_FAILED:网络请求失败,是因为 CORS 策略拒绝加载 JavaScript 文件。

报错原因

现代浏览器的安全机制 CORS(跨域资源共享) 仅支持以下协议:

  • http / https
  • data
  • chrome-extension
  • 等等

file:// 协议不在允许列表内,因此直接打开 HTML 文件并加载 JavaScript 时会触发错误。

解决方案

方法一:使用本地 HTTP 服务器(推荐)

最根本的解决方法是通过本地 HTTP 服务器运行项目,而不是直接打开 file:// 链接。

1. 使用 VSCode 的 Live Server 插件

  • 安装 Live Server 插件:

    • 打开 VSCode,进入插件市场,搜索 "Live Server" 并安装。
  • 启动 Live Server:

    • 在项目目录下右键点击 index.html 文件,选择 "Open with Live Server"
  • 浏览器自动打开页面,访问地址:

    http://localhost:5500

2. 使用 Python 内置 HTTP 服务器

Python 自带一个简单的 HTTP 服务器,可以在本地快速启动:

  • 打开命令行终端,进入 HTML 文件所在目录:

    cd D:/web_study/20241217
  • 运行以下命令(Python 3.x):

    python -m http.server 8000
  • 在浏览器中访问:

    http://localhost:8000/index.html

3. 使用 Node.js 的 http-server 工具

如果你安装了 Node.js,可以使用 http-server 包:

  • 安装 http-server

    npm install -g http-server
  • 启动服务器:

    http-server
  • 浏览器访问:

    http://localhost:8080

方法二:调整 Chrome 浏览器启动参数(临时解决,不推荐)

这种方法临时禁用浏览器的安全策略,仅适用于测试环境。不要在生产环境使用!

  • 在 Chrome 浏览器启动时添加以下参数:

    chrome.exe --allow-file-access-from-files --disable-web-security
  • 然后重新打开 HTML 文件。

⚠️ 警告:此方法存在安全风险,绕过了浏览器的安全机制,仅用于临时测试。


总结

出现 "Access to script at ... has been blocked by CORS policy" 的错误,通常是因为浏览器默认禁止了通过 file:// 协议加载外部资源。解决这个问题最好的方法是使用本地 HTTP 服务器运行项目,比如:

  • VSCode 的 Live Server 插件
  • Python 内置服务器
  • Node.js 的 http-server 工具

通过这些工具,你可以在本地以 http:// 协议访问文件,解决 CORS 报错问题,提升开发效率。

推荐做法

启动一个本地 HTTP 服务器,这是现代前端开发的标准做法,既安全又高效。


希望这篇文章能帮你解决开发中遇到的 CORS 问题!😊 如果有其他问题,欢迎留言交流。

最近chatgpt一直出问题,所以打算开始用claude来代替了。
今天试用了一下,感觉体验比以前用的时候要好,也比现在用chatgpt的体验要好。
所以打算开始替换。