写给王守恩，供参考

nyy

写代码，要有注释、有缩进、不要层层嵌套，要把代码放到代码框里面（方便别人直接点击复制，然后复制代码），
要有输出结果（方便别人先从结果检验你的结果是否正确，如果结果都不对，别人就没兴趣看了），
用LaTeX展示最终结果。


示范代码
难倒全班的初中几何题！
https://bbs.emath.ac.cn/thread-20076-1-1.html
(出处: 数学研发论坛)
https://bbs.emath.ac.cn/forum.ph ... 0076&pid=105017

第一行

1. Clear["Global`*"];(*mathematica11.2,win7(64bit)Clear all variables*)

复制代码

首先清楚所有变量，这样别人运行我的代码的时候，别人之前使用的变量，与我的代码的变量就不会发生冲突了！这是排除潜在的可能的雷！
并且告诉别人，我的软件的版本，操作系统、操作系统的版本，32位还是64位，这样如果别人输出结果与我的不一样，
方便查找原因。

我在注释中交代了

1. (*假设AE=a,CD=b,DB=c,AB=d,DF=e,AF=3e,列方程组解决问题*)

复制代码

因此阅读的人很容易知道我的变量表示啥意思。

第5行到第9行，列了5个方程，并且缩进，这样层次感很强，方便阅读理解。
我估计把这五个方程放在五行里面，不放在一行里面，这样方便阅读。而不是像

1. 2^2+(b+c)^2==a^2,(*△BCE勾股定理*)

复制代码

前面表示列的方程，后面的

1. (*△BCE勾股定理*)

复制代码

表示注释，
并且交代了在△BCE，如果只写勾股定理，不方便理解，指明三角形，方便检验。

在论坛上使用mathematica导出的LaTeX办法。
1、选中要导出的结果（蓝色展示）。
2、右键/复制为/LaTeX
3、在论坛上输入

1. \[

复制代码

与

1. \]

复制代码

，把第二步复制的代码粘贴到两者之间。
LaTeX结果，展示起来更好看。

aimisiyou

你在教我做事？

wayne

Mathematica只是草稿纸，随便写写改改，写完代码拿到答案了，草稿纸就可以扔到垃圾篓了，就这么简单。
把时间浪费在茴香豆有几种写法，注释怎么写更好看，就不合适了，如果还教导别人学你，就玩过头了哈。

不同的人用的工具，草稿纸的材质不一样，我好奇，如果我教导你，多学学mathe，人家用的是C/C++,PARI/Gp， 你会是一种什么感觉 ，mathematica同学，@nyy

nyy

wayne 发表于 2025-4-11 11:37
Mathematica只是草稿纸，随便写写改改，写完代码拿到答案了，草稿纸就可以扔到垃圾篓了，就这么简单。
把时 ...

你我要求不一样。
我写的代码是共享给别人的。
方便别人理解。
如果我写出来了别人不理解或者理解不了，
那我就白写了。
我之所以跟他说这个，是他与我用一样的软件。
而不是cpp

aimisiyou

你笑起来真好看

northwolves

"If our programming languages were expressive enough, or if we had the talent to subtly wield those languages to express our intent, we would not need comments very much—perhaps not at all."
-- Robert C.Martin 《Clean Code》

nyy

northwolves 发表于 2025-4-11 21:27
"If our programming languages were expressive enough, or if we had the talent to subtly wield those  ...

绝大多数时候，人类的语言要比计算机语言更容易理解，
所以我坚持写注释。

nyy

用vim写mathematica代码的一个好处!
https://bbs.emath.ac.cn/thread-4437-1-1.html
(出处: 数学研发论坛)

这个属于快速添加注释符号

灵树

写注释的好处不光是给别人看也是给自己看，一段代码当时写的时候每行都很明白，过段时间回去再看就很难和当时的思路同步起来。有注释就更容易理解当时的想法，代码读起来会好很多，代码量越大注释的好处越明显。专业的开发还需要更专业的工具如UML来辅助开发。

nyy

用vim写mathematica代码的一个好处!
https://bbs.emath.ac.cn/thread-4437-1-1.html
(出处: 数学研发论坛)

按照这儿的办法配置vim，让你不太讨厌写mathematica注释，
mathematica的注释符号，需要输入四个符号，然后再移动光标才能写注释，
所以我很理解为什么很多人不喜欢写mathematica代码的注释，如果不用编辑器的映射功能，
写注释真的非常的累人！

mathematica代码替换变量的vim代码
https://bbs.emath.ac.cn/thread-20066-1-1.html
(出处: 数学研发论坛)

按照这儿的办法配置vim的菜单，最后处理mathematica代码