ustclug / mirrorhelp

Documentation for USTC Mirrors
https://mirrors.ustc.edu.cn/help/
Other
509 stars 147 forks source link

fix(crates.io-index): fix config file path error when install rust without default CARGO_HOME environment variable #230

Closed cloudfstrife closed 1 year ago

cloudfstrife commented 1 year ago

cargo 安装时,如果没有指定 CARGO_HOME 时,默认的 CARGO_HOME 路径为 ~/.cargo cargo 的配置文件路径 $CARGO_HOME/config.toml, 但是如果用户配置了 CARGO_HOME 环境变量,则配置文件的路径不再是 ~/.cargo/config.toml,详细内容参见: The Cargo Book Configuration

PR修正了文本中的路径(使用 $CARGO_HOME/config.toml 替换 ~/.cargo/config,原本的配置文件没有.toml后缀,不确定之前的文档是否正确)。并增加了 Linux 环境下写入配置文件的命令。

taoky commented 1 year ago

关于 toml:

Note: Cargo also reads config files without the .toml extension, such as .cargo/config. Support for the .toml extension was added in version 1.39 and is the preferred form. If both files exist, Cargo will use the file without the extension.

taoky commented 1 year ago

然后需要考虑到看帮助的用户很可能不知道 CARGO_HOME 是什么意思——我建议在第一个备注上面加一些描述性文本指出其在 Windows 和 Unix 上的位置。

cloudfstrife commented 1 year ago

@taoky 上面两个回复相关的内容已修正

cloudfstrife commented 1 year ago

@taoky @ksqsf 我修改了整体的文件结构以使它更符合阅读习惯 首先是最基本的使用方法,然后是版本1.68+的稀疏索引的支持,最后是 warn 部分以及常见问题的解决方案

ZenithalHourlyRate commented 1 year ago

Could this be ported to https://github.com/mirrorz-org/mirrorz-help/blob/master/contents/crates.io-index.mdx

taoky commented 1 year ago

Could this be ported to https://github.com/mirrorz-org/mirrorz-help/blob/master/contents/crates.io-index.mdx

@cloudfstrife 有兴趣去 mirrorz-help 项目交 PR 吗?

cloudfstrife commented 1 year ago

收到